فقط پیش نمایش — فعال سازی لازم است

دانلودها را با QuickDL بسازید

QuickDL به توسعه دهندگان اجازه می دهد تا مدل درخواست فشرده را قبل از فعال سازی بررسی کنند.پشتیبانی باید قبل از اینکه یک کلید خصوصی و سهمیه قابل استفاده شود ، محصول را تایید کند.

QuickDlJobsJSON در HTTPSکارهای غیر همزمانمدارک اعتباری محدوده‌دار
01

شروع سریع

در QuickDL، اعتبارنامه‌های فعال‌شده توسط پشتیبانی هنگام توضیح میزبان API اولویت دارند. این ابزار جمع‌وجور با یک نقطه انتهایی مستأجر اختصاص‌یافته ادامه می‌دهد و با مسیر تماس فقط سرور پایان می‌یابد.

نشانی وب مستاجرhttps://quickdl.app
احراز هویتX-API-Key: pending_activation_…
پروفایل مشتریQuickDlJobs
نسخه APIv1
# 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 ایمنی اعتبارنامه را با شناسایی ابتدا ذخیره‌سازی مخفی سمت سرور مدیریت می‌کند. سپس بدون جاسازی بسته کلاینت ادامه می‌دهد و هیچ لاگ یا مخزن عمومی را در دید نگه نمی‌دارد.

02

حل یک پیوند

در 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 را با شناسایی ابتدایی مقدار بازگشتی بدون تغییر اداره می کند. این با در دسترس بودن هر لینک دنبال می شود و هیچ برچسب کیفیت حدس زده شده ای را در نظر نمی گیرد.

03

ایجاد و پیگیری یک کار دانلود

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"}'
1202 پذیرفته شدذخیره quick_job.
2وضعیت نظرسنجیGET /v1/jobs/{quick_job} با همان کلید
3آمادهآدرس دانلود امضا شده را باز کنید.
وضعیتمعنیعمل مشتری
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. نکته نهایی آن تحویل موقت امضا شده است.

04

خطاهای قابل پیش بینی

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": "…"
}
انتقال ابرمتنمعنی معمولکنش
400URL نامعتبر، بدنه یا فرمت در دسترس نیست.درخواست را اصلاح کنید.برای فرمت ها دوباره حل کنید.
401کلید گمشده، نامعتبر، منقضی شده یا با دامنه اشتباه.اعتبار جانبی سرور را بررسی کنید.
403مستاجر یا منبع سیاست درخواست را رد کرد.از سیاست دور نشوید با پشتیبانی تماس بگیرید
404شغل نامعلوم یا منقضی شدهدر صورت لزوم یک شغل جدید ایجاد کنید.
429درخواست یا حد فعال-کار رسیده است.افتخار retry_after_seconds.
503صف / ظرفیت یا بالادست به طور موقت در دسترس نیست.دوباره با عقب نشینی نمایی و جیتر سعی کنید.
05

قرارداد عملیاتی

QuickDL یک کوتا فشرده و اختصاصی برای مشتری اعطا می کند که از یکپارچگی بدون بی ثبات کردن خدمات منبع پشتیبانی می کند.

در QuickDL، فعال سازی قبل از کاوش در هنگام توضیح دسترسی به Schema اول می آید. آن ابزار فشرده با احراز هویت اختصاص داده شده دنبال می شود و روی اشکال درخواست مستند بسته می شود.

دسترسی بازبینی شده توسط اپراتور

فعال سازی از طریق پشتیبانی

نام یکپارچه‌سازی، حجم ماهانه مورد انتظار و منابع مورد نیاز را به QuickDL ارائه دهید. عملیات‌هایی که سرور انجام خواهد داد را مشخص کنید تا تأیید، کلیدی یک‌بار مصرف و با دامنه محدود تولید کند.

درخواست فعال سازی کلیدها محدوده مستاجر، قابل لغو و از طریق فرم تماس صادر می شوند.اسکریپت های ناشناس نمی توانند کار دانلودر را اجرا کنند.