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

# Available only after support activation
export DWYT_FLOW_SECRET="issued-after-review"

curl -X POST https://dwyt.app/v1/resolve \
  -H "X-API-Key: $DWYT_FLOW_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"public_media":"https://www.youtube.com/watch?v=VIDEO_ID"}'

بالنسبة لسلامة Credential ، يبدأ DWYT مع التخزين السري لجانب الخادم. تزوج خريطة الشكل الخاصة به ذلك مع عدم وجود دمج حزمة العميل وتنتهي بدون سجلات أو مستودعات عامة.

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

بالنسبة لمعرف الشكل، يبدأ DWYT مع القيمة المرجعية دون تغيير.تقوم خريطة الشكل الخاصة به بمضاهاة ذلك مع توفر لكل رابط وتنتهي بدون علامة جودة تخمينية.

curl -X POST https://dwyt.app/v1/jobs \
  -H "X-API-Key: $DWYT_FLOW_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"public_media":"https://www.youtube.com/watch?v=VIDEO_ID","rendition_key":"18"}'

curl https://dwyt.app/v1/jobs/FLOW_ID \
  -H "X-API-Key: $DWYT_FLOW_SECRET"

يبدأ استطلاع الوظائف مع الانتظار الأولي لمدة ثانية واحدة على DWYT. ثم تقدم خريطة الشكل هذه الركود المقفل. الحقيقة النهائية هي التسليم المؤقت الموقع.

{
  "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": "…"
}

• استخدم منطق التطبيق idempotent ولا تبدأ أبدًا وظائف مكررة لنفس نقرة المستخدم.
• تقوم ذاكرة التخزين المؤقت بحل البيانات الوصفية باختصار ، ولكنها تعامل دائمًا عناوين URL الموقّعة للتنزيل على أنها تنتهي صلاحيتها.
• استخدام الارتداد الأسي المحدود مع التشتت لـ 429, 503 والأخطاء القابلة لإعادة المحاولة.
• لا تعالج سوى الوسائط العامة أو الوسائط التي تم الإذن لك بالوصول إليها. لا يتم تجاوز DRM وضوابط الوصول.
• احتفظ بأرقام تعريف الطلبات وأرقام تعريف الوظائف في سجلات التشغيل الخاصة.لا تسجل عناوين URL المقدمة دون داع.

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