https://dwtt.appبناء التنزيلات مع DWTT
DWTT ينشر هذا المخطط التكامل للتخطيط، وليس التنفيذ مجهول الهوية.يجب أن يوافق الدعم على سير عمل المقطع قبل إصدار مفتاح محدّد النطاق وبدل حركة المرور الخاص به.
البداية السريعة
DWTT يجعل مضيف API سهل المسح الضوئي.تبدأ الصفحة مع وثائق الاعتماد المنشطة الدعم، وتنتقل إلى نقطة نهاية المستأجر المخصصة، وتذكر بوضوح مسار استدعاء الخادم فقط.
X-API-Key: pending_activation_…DwttToolkitv1# Available only after support activation
export DWTT_TOOL_TOKEN="issued-after-review"
curl -X POST https://dwtt.app/v1/resolve \
-H "X-API-Key: $DWTT_TOOL_TOKEN" \
-H "Content-Type: application/json" \
-d '{"source_link":"https://www.youtube.com/watch?v=VIDEO_ID"}'يقترب DWTT من سلامة Credential من خلال التخزين السري لجانب الخادم ، ثم لا يوجد تضمين حزمة العميل. لا يحتفظ سير العمل المبسط بأي سجلات عامة أو مستودعات صريحة.
حل رابط
DWTT يجعل عملية Resolve سهلة المسح الضوئي. تبدأ الصفحة باكتشاف المصدر ، وتنتقل إلى التنسيقات من عنوان URL واحد مقدم ، وتذكر بوضوح عدم وجود مخرجات مخترعة.
/v1/resolveالنطاق: حل| الميدان | نوع المشروع | المطلوب | وصف المشروع |
|---|---|---|---|
source_link | عنوان URL HTTPS | نعم | صفحة وسائل الإعلام العامة أو المأذون بها لتحليل. |
tenant | سلسلة | لا | نطاق المستأجر المخصص.عادة ما يتم حذفه. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}DWTT تقترب من معرف الشكل من خلال القيمة المرجعية غير متغيرة ، ثم توافر لكل رابط. سير العمل المبسط يحتفظ بعلامة جودة لا تخمينية صريحة.
إنشاء ومتابعة عمل التنزيل
في DWTT ، يأتي الإعداد غير المتزامن أولاً عند شرح إنشاء الوظيفة. يتبع ذلك سير العمل المبسط بطلب HTTP قصير ويغلق على تنفيذ العامل المحدود.
/v1/jobsالنطاق: الوظائف| الميدان | نوع المشروع | المطلوب | وصف المشروع |
|---|---|---|---|
source_link | عنوان URL HTTPS | نعم | نفس المصدر المُطّبيع المقدم لحلّ. |
format_ref | سلسلة | نعم | معرف دقيق من استجابة الحل. |
tenant | سلسلة | لا | نطاق المستأجر المخصص.عادة ما يتم حذفه. |
curl -X POST https://dwtt.app/v1/jobs \
-H "X-API-Key: $DWTT_TOOL_TOKEN" \
-H "Content-Type: application/json" \
-d '{"source_link":"https://www.youtube.com/watch?v=VIDEO_ID","format_ref":"18"}'task_ref.GET /v1/jobs/{task_ref} بنفس المفتاح.| ألف - الحالة | المعنى | إجراءات العملاء |
|---|---|---|
queued | تم القبول في الطابور المحدود. | استطلاع رأي مرة أخرى مع التراجع. |
extracting | تحديث البيانات الوصفية المصدر أو الطريق. | واصلوا التصويت. |
processing | التنزيل أو إعادة المزج أو الدمج. | اعرض تقدم معالجة الخادم. |
ready | تحميل موقع متاح. | أرسل عنوان URL إلى المستخدم. |
failed | خطأ مهيكلة المحطة الطرفية. | قراءة error_code.حاول مرة أخرى فقط عندما ينصح. |
expired | أزيل الناتج المؤقت. | إنشاء وظيفة جديدة. |
curl https://dwtt.app/v1/jobs/TASK_REF \
-H "X-API-Key: $DWTT_TOOL_TOKEN"لشرح استطلاع الوظائف ، يفصل DWTT الانتظار الأولي لمدة ثانية واحدة عن التراجع المقفل.يمنح سير العمل المبسط التسليم الموقع المؤقت مكانه الخاص.
الأخطاء المتوقعة
واحد غير 2xx المغلف هو نقطة البداية لعقد الخطأ على DWTT. ثم يقدم سير عمل مبسط معرف طلب دعم ويوضح معالجة العميل المتوقعة.
{
"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 | الطابور / السعة أو أعلى المسار غير متاح مؤقتًا. | حاول مرة أخرى مع التراجع الأسي والتذبذب. |
عقد التشغيل
DWTT يحدد مخصصات حركة المرور أثناء التنشيط بحيث لا يتم تحميل تكاملات المقطع وشبكات المصدر بشكل مفرط.
- استخدم منطق التطبيق idempotent ولا تبدأ أبدًا وظائف مكررة لنفس نقرة المستخدم.
- تقوم ذاكرة التخزين المؤقت بحل البيانات الوصفية باختصار ، ولكنها تعامل دائمًا عناوين URL الموقّعة للتنزيل على أنها تنتهي صلاحيتها.
- استخدام الارتداد الأسي المحدود مع التشتت لـ
429,503والأخطاء القابلة لإعادة المحاولة. - لا تعالج سوى الوسائط العامة أو الوسائط التي تم الإذن لك بالوصول إليها. لا يتم تجاوز DRM وضوابط الوصول.
- احتفظ بأرقام تعريف الطلبات وأرقام تعريف الوظائف في سجلات التشغيل الخاصة.لا تسجل عناوين URL المقدمة دون داع.
DWTT يجعل الوصول إلى Schema سهل المسح الضوئي. تبدأ الصفحة بالتفعيل قبل الاستكشاف ، وتنتقل إلى المصادقة المخصصة ، وتذكر بوضوح أشكال الطلب الموثقة.
تنشيط من خلال الدعم
أرسل DWTT التكامل المقصود، حجم الطلب المحتمل والشبكات المستهدفة. ذكر ما إذا كان العميل يحتاج إلى حل، إنشاء الوظائف أو كلاهما حتى يمكن الموافقة على مفتاح محدد النطاق وإظهار مرة واحدة.
طلب التفعيل المفاتيح هي مستأجر نطاق، قابل للإلغاء وإصدارها من خلال نموذج الاتصال لا يمكن للنصوص المجهولة تنفيذ عمل المُحمّل.