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 يتعامل مع سلامة Credential من خلال التعرف أولاً على التخزين السري لجانب الخادم. يتبع مع عدم وجود دمج حزمة العميل ولا يحتفظ بأي سجلات عامة أو مستودعات في الرؤية.
حل رابط
في 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 يتعامل مع معرف الشكل من خلال تحديد القيمة المعادة أولاً دون تغيير. يتبع مع توافر لكل رابط ولا يحتفظ بأي علامة جودة تخمينية في الرؤية.
إنشاء ومتابعة عمل التنزيل
تستعرض الأداة المساعدة المدمجة لـ 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"}'quick_job.GET /v1/jobs/{quick_job} بنفس المفتاح.| ألف - الحالة | المعنى | إجراءات العملاء |
|---|---|---|
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 يقدم ثلاث نقاط عملية لاستطلاع الوظائف. أولاً يأتي الانتظار الأولي لمدة ثانية واحدة. ثم تغطي المنفعة المدمجة الركود المقفل. نقطة نهائيه هي التسليم الموقع مؤقتًا.
الأخطاء المتوقعة
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 اسم التكامل، والحجم الشهري المتوقع والمصادر المطلوبة.حدد العمليات التي سيقوم بها الخادم بحيث تنتج الموافقة مفتاحًا ضيق النطاق وغير متكرر.
طلب التفعيل المفاتيح هي مستأجر نطاق، قابل للإلغاء وإصدارها من خلال نموذج الاتصال لا يمكن للنصوص المجهولة تنفيذ عمل المُحمّل.