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

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

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

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

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

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

عنوان URL المستأجرhttps://dwtt.app
التوثيقX-API-Key: pending_activation_…
نبذة عن العميلDwttToolkit
إصدار APIv1
# 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 من خلال التخزين السري لجانب الخادم ، ثم لا يوجد تضمين حزمة العميل. لا يحتفظ سير العمل المبسط بأي سجلات عامة أو مستودعات صريحة.

02

حل رابط

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 تقترب من معرف الشكل من خلال القيمة المرجعية غير متغيرة ، ثم توافر لكل رابط. سير العمل المبسط يحتفظ بعلامة جودة لا تخمينية صريحة.

03

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

في 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"}'
1202 مقبولةحفظ task_ref.
2حالة الاستفتاءGET /v1/jobs/{task_ref} بنفس المفتاح.
3جاهزافتح عنوان URL للتنزيل الموقّع.
ألف - الحالةالمعنىإجراءات العملاء
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 الانتظار الأولي لمدة ثانية واحدة عن التراجع المقفل.يمنح سير العمل المبسط التسليم الموقع المؤقت مكانه الخاص.

04

الأخطاء المتوقعة

واحد غير 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الطابور / السعة أو أعلى المسار غير متاح مؤقتًا.حاول مرة أخرى مع التراجع الأسي والتذبذب.
05

عقد التشغيل

DWTT يحدد مخصصات حركة المرور أثناء التنشيط بحيث لا يتم تحميل تكاملات المقطع وشبكات المصدر بشكل مفرط.

DWTT يجعل الوصول إلى Schema سهل المسح الضوئي. تبدأ الصفحة بالتفعيل قبل الاستكشاف ، وتنتقل إلى المصادقة المخصصة ، وتذكر بوضوح أشكال الطلب الموثقة.

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

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

أرسل DWTT التكامل المقصود، حجم الطلب المحتمل والشبكات المستهدفة. ذكر ما إذا كان العميل يحتاج إلى حل، إنشاء الوظائف أو كلاهما حتى يمكن الموافقة على مفتاح محدد النطاق وإظهار مرة واحدة.

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