بناء التنزيلات مع downf.io

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

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

تبدأ سلامة وثائق الاعتماد مع التخزين السري لجانب الخادم على DownF. ثم يقدم هذا التوافق نظرة لا تتضمن حزمة العميل. الحقيقة النهائية هي عدم وجود سجلات عامة أو مستودعات.

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

يبدأ معرف التنسيق مع القيمة المرجعية دون تغيير على DownF. ثم يقدم هذا عرض التوافق توافر لكل رابط. الحقيقة النهائية هي لا تخمين علامة الجودة.

curl -X POST https://downf.io/v1/jobs \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_address":"https://www.youtube.com/watch?v=VIDEO_ID","output_ref":"18"}'

curl https://downf.io/v1/jobs/TRANSFER_REF \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN"

تعرض طريقة عرض التوافق في DownF انتظارًا أوليًا لمدة ثانية واحدة لاستطلاع الوظائف. تُظهر التراجع المحدود التالي ولا تخفي التسليم المؤقت الموقع.

{
  "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 المقدمة دون داع.

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