https://quickdl.appدانلودها را با QuickDL بسازید
QuickDL به توسعه دهندگان اجازه می دهد تا مدل درخواست فشرده را قبل از فعال سازی بررسی کنند.پشتیبانی باید قبل از اینکه یک کلید خصوصی و سهمیه قابل استفاده شود ، محصول را تایید کند.
شروع سریع
در QuickDL، اعتبارنامههای فعالشده توسط پشتیبانی هنگام توضیح میزبان API اولویت دارند. این ابزار جمعوجور با یک نقطه انتهایی مستأجر اختصاصیافته ادامه میدهد و با مسیر تماس فقط سرور پایان مییابد.
X-API-Key: pending_activation_…QuickDlJobsv1# Available only after support activation
export QUICKDL_JOB_KEY="issued-after-review"
curl -X POST https://quickdl.app/v1/resolve \
-H "X-API-Key: $QUICKDL_JOB_KEY" \
-H "Content-Type: application/json" \
-d '{"public_link":"https://www.youtube.com/watch?v=VIDEO_ID"}'QuickDL ایمنی اعتبارنامه را با شناسایی ابتدا ذخیرهسازی مخفی سمت سرور مدیریت میکند. سپس بدون جاسازی بسته کلاینت ادامه میدهد و هیچ لاگ یا مخزن عمومی را در دید نگه نمیدارد.
حل یک پیوند
در QuickDL، تشخیص منبع ابتدا هنگام توضیح عملیات Resolve انجام میشود. این ابزار جمعوجور سپس فرمتها را از یک URL ارسالشده دنبال میکند و بدون خروجیهای اختراعی پایان مییابد.
/v1/resolveدامنه: حل| فیلد | نوع | لازم است | شرح |
|---|---|---|---|
public_link | نشانی وب HTTPS | بله | صفحه رسانه های عمومی یا مجاز برای تجزیه و تحلیل. |
tenant | رشته | نه | دامنه مستاجر اختصاص داده شده.معمولا حذف می شود. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}QuickDL شناسه Format را با شناسایی ابتدایی مقدار بازگشتی بدون تغییر اداره می کند. این با در دسترس بودن هر لینک دنبال می شود و هیچ برچسب کیفیت حدس زده شده ای را در نظر نمی گیرد.
ایجاد و پیگیری یک کار دانلود
QuickDL: utility فشرده بررسی آماده سازی غیر همزمان برای ایجاد کار.این یک درخواست HTTP کوتاه را در ادامه نشان می دهد و اجرای کارگر محدود را مخفی نمی کند.
/v1/jobsحوزه: مشاغل| فیلد | نوع | لازم است | شرح |
|---|---|---|---|
public_link | نشانی وب HTTPS | بله | همان منبع نرمال شده ارائه شده برای حل. |
download_option | رشته | بله | یک شناسه دقیق از پاسخ حل. |
tenant | رشته | نه | دامنه مستاجر اختصاص داده شده.معمولا حذف می شود. |
curl -X POST https://quickdl.app/v1/jobs \
-H "X-API-Key: $QUICKDL_JOB_KEY" \
-H "Content-Type: application/json" \
-d '{"public_link":"https://www.youtube.com/watch?v=VIDEO_ID","download_option":"18"}'quick_job.GET /v1/jobs/{quick_job} با همان کلید| وضعیت | معنی | عمل مشتری |
|---|---|---|
queued | پذیرفته شده در صف محدود شده | دوباره با عقب نشینی نظرسنجی کنید. |
extracting | بازسازی متادیتا یا مسیر منبع | به نظر سنجی ادامه دهید. |
processing | دانلود کردن، ریماکس کردن یا ادغام کردن | نمایش پیشرفت سرور |
ready | دانلود امضا شده در دسترس است. | آدرس را برای کاربر ارسال کنید. |
failed | خطای ساختاری ترمینال | خوانده شده error_code.فقط در صورت توصیه دوباره سعی کنید |
expired | خروجی موقت حذف شد. | ایجاد یک شغل جدید |
curl https://quickdl.app/v1/jobs/QUICK_JOB \
-H "X-API-Key: $QUICKDL_JOB_KEY"QuickDL سه نکته عملی برای Job polling ارائه می دهد. اول یک ثانیه انتظار اولیه می آید. utilite فشرده سپس پوشش می دهد capped backoff. نکته نهایی آن تحویل موقت امضا شده است.
خطاهای قابل پیش بینی
QuickDL نزدیک می شود قرارداد خطا از طریق یک پاکت غیر 2xx، سپس یک شناسه درخواست پشتیبانی.کاربرد فشرده، مدیریت پیش بینی پذیر مشتری را صریح نگه می دارد.
{
"success": false,
"error": {
"code": "RATE_LIMITED",
"category": "rate_limited",
"message": "Too many requests. Please try again shortly.",
"retryable": true,
"details": {"retry_after_seconds": 20}
},
"request_id": "…"
}| انتقال ابرمتن | معنی معمول | کنش |
|---|---|---|
| 400 | URL نامعتبر، بدنه یا فرمت در دسترس نیست. | درخواست را اصلاح کنید.برای فرمت ها دوباره حل کنید. |
| 401 | کلید گمشده، نامعتبر، منقضی شده یا با دامنه اشتباه. | اعتبار جانبی سرور را بررسی کنید. |
| 403 | مستاجر یا منبع سیاست درخواست را رد کرد. | از سیاست دور نشوید با پشتیبانی تماس بگیرید |
| 404 | شغل نامعلوم یا منقضی شده | در صورت لزوم یک شغل جدید ایجاد کنید. |
| 429 | درخواست یا حد فعال-کار رسیده است. | افتخار retry_after_seconds. |
| 503 | صف / ظرفیت یا بالادست به طور موقت در دسترس نیست. | دوباره با عقب نشینی نمایی و جیتر سعی کنید. |
قرارداد عملیاتی
QuickDL یک کوتا فشرده و اختصاصی برای مشتری اعطا می کند که از یکپارچگی بدون بی ثبات کردن خدمات منبع پشتیبانی می کند.
- از منطق برنامه idempotent استفاده کنید و هرگز کارهای تکراری را برای همان کلیک کاربر شروع نکنید.
- حافظه نهان به طور خلاصه فراداده را حل می کند، اما همیشه با URL های دانلود امضا شده به عنوان انقضا رفتار می کند.
- استفاده از پسانداز نمایی محدود شده با جیتر برای
429,503و خطاهای قابل بازنگری - فقط رسانه های عمومی یا رسانه هایی را که مجاز به دسترسی به آنها هستید پردازش کنید. DRM و کنترل های دسترسی دور زده نمی شوند.
- شناسه های درخواست و شناسه های کار را در لاگ های عملیاتی خصوصی نگه دارید. URL های ارسال شده را بدون نیاز به آن لاگ نکنید.
در QuickDL، فعال سازی قبل از کاوش در هنگام توضیح دسترسی به Schema اول می آید. آن ابزار فشرده با احراز هویت اختصاص داده شده دنبال می شود و روی اشکال درخواست مستند بسته می شود.
فعال سازی از طریق پشتیبانی
نام یکپارچهسازی، حجم ماهانه مورد انتظار و منابع مورد نیاز را به QuickDL ارائه دهید. عملیاتهایی که سرور انجام خواهد داد را مشخص کنید تا تأیید، کلیدی یکبار مصرف و با دامنه محدود تولید کند.
درخواست فعال سازی کلیدها محدوده مستاجر، قابل لغو و از طریق فرم تماس صادر می شوند.اسکریپت های ناشناس نمی توانند کار دانلودر را اجرا کنند.