عرض مسبق فقط — يلزم التفعيل

بناء التنزيلات مع QuickDL

QuickDL يتيح للمطورين فحص نموذج الطلب المضغوط قبل التفعيل.يجب على الدعم التحقق من صحة المنتج قبل أن يصبح مفتاح خاص وحصص قابلة للاستخدام.

QuickDlJobsJSON عبر HTTPSوظائف غير متزامنةوثائق التفويض المحددة النطاق
01

البداية السريعة

في QuickDL، تأتي وثائق الاعتماد المنشطة بالدعم أولاً عند شرح مضيف API. تتبع تلك الأداة المساعدة المدمجة مع نقطة نهاية مستأجرة مخصصة وتغلق على مسار استدعاء الخادم فقط.

عنوان URL المستأجر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 يتعامل مع سلامة Credential من خلال التعرف أولاً على التخزين السري لجانب الخادم. يتبع مع عدم وجود دمج حزمة العميل ولا يحتفظ بأي سجلات عامة أو مستودعات في الرؤية.

02

حل رابط

في QuickDL ، يأتي اكتشاف المصدر أولاً عند شرح عملية Resolve. تلك الأداة المساعدة المدمجة تتبع مع تنسيقات من عنوان URL واحد مقدم وتغلق على لا مخرجات مخترعة.

الوظائف/v1/resolveالنطاق: حل
الميداننوع المشروعالمطلوبوصف المشروع
public_linkعنوان URL HTTPSنعمصفحة وسائل الإعلام العامة أو المأذون بها لتحليل.
tenantسلسلةلانطاق المستأجر المخصص.عادة ما يتم حذفه.
{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

QuickDL يتعامل مع معرف الشكل من خلال تحديد القيمة المعادة أولاً دون تغيير. يتبع مع توافر لكل رابط ولا يحتفظ بأي علامة جودة تخمينية في الرؤية.

03

إنشاء ومتابعة عمل التنزيل

تستعرض الأداة المساعدة المدمجة لـ QuickDL الإعداد غير المتزامن لإنشاء الوظيفة. يظهر طلب HTTP قصير التالي ولا يحجب تنفيذ العامل المحدود.

الوظائف/v1/jobsالنطاق: الوظائف
الميداننوع المشروعالمطلوبوصف المشروع
public_linkعنوان URL 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جاهزافتح عنوان URL للتنزيل الموقّع.
ألف - الحالةالمعنىإجراءات العملاء
queuedتم القبول في الطابور المحدود.استطلاع رأي مرة أخرى مع التراجع.
extractingتحديث البيانات الوصفية المصدر أو الطريق.واصلوا التصويت.
processingالتنزيل أو إعادة المزج أو الدمج.اعرض تقدم معالجة الخادم.
readyتحميل موقع متاح.أرسل عنوان URL إلى المستخدم.
failedخطأ مهيكلة المحطة الطرفية.قراءة error_code.حاول مرة أخرى فقط عندما ينصح.
expiredأزيل الناتج المؤقت.إنشاء وظيفة جديدة.
curl https://quickdl.app/v1/jobs/QUICK_JOB \
  -H "X-API-Key: $QUICKDL_JOB_KEY"

QuickDL يقدم ثلاث نقاط عملية لاستطلاع الوظائف. أولاً يأتي الانتظار الأولي لمدة ثانية واحدة. ثم تغطي المنفعة المدمجة الركود المقفل. نقطة نهائيه هي التسليم الموقع مؤقتًا.

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": "…"
}
بروتوكول نقل الملفات السريعالمعنى النموذجيالإجراء
400عنوان URL غير صحيح أو جسم أو تنسيق غير متاح.تصحيح الطلب.حل مرة أخرى للأشكال.
401مفتاح مفقود أو غير صالح أو منتهية الصلاحية أو ذات نطاق خاطئ.تحقق من وثائق الاعتماد على جانب الخادم.
403رفضت سياسة المستأجر أو المصدر الطلب.لا تتجاوز السياسة اتصل بالدعم.
404وظيفة غير معروفة أو منتهية الصلاحية.قم بإنشاء وظيفة جديدة إذا كان ذلك مناسبًا.
429طلب أو حد الوظائف النشطة تم الوصول إليه.الشرف retry_after_seconds.
503الطابور / السعة أو أعلى المسار غير متاح مؤقتًا.حاول مرة أخرى مع التراجع الأسي والتذبذب.
05

عقد التشغيل

QuickDL يمنح حصة مدمجة، محددة العميل التي تدعم التكامل دون زعزعة استقرار خدمات المصدر.

في QuickDL ، يأتي التفعيل قبل الاستكشاف أولاً عند شرح الوصول إلى Schema. تلك الميزة المدمجة تتبع مع المصادقة المخصصة وتغلق على أشكال الطلب الموثقة.

الوصول الذي يستعرضه المشغل

تنشيط من خلال الدعم

توفر QuickDL اسم التكامل، والحجم الشهري المتوقع والمصادر المطلوبة.حدد العمليات التي سيقوم بها الخادم بحيث تنتج الموافقة مفتاحًا ضيق النطاق وغير متكرر.

طلب التفعيل المفاتيح هي مستأجر نطاق، قابل للإلغاء وإصدارها من خلال نموذج الاتصال لا يمكن للنصوص المجهولة تنفيذ عمل المُحمّل.