فقط پیش نمایش — فعال سازی لازم است

ساخت دانلود ها با downf.io

DownF اجرای API را تا زمانی که یک اپراتور مورد استفاده سازگاری را بررسی کند ، غیرفعال نگه می دارد. مثال ها قرارداد برنامه ریزی شده را توصیف می کنند ، در حالی که مدارک و سهمیه های واقعی فقط از طریق فعال سازی پشتیبانی می رسند.

DownfBridgeJSON در HTTPSکارهای غیر همزمانمدارک اعتباری محدوده‌دار
01

شروع سریع

DownF میزبان API را در اطراف مدارک شناسایی فعال شده توسط پشتیبانی سازماندهی می کند.نمایش سازگاری آن یک نقطه پایانی مستاجر اختصاص داده شده را مقایسه می کند.یک مسیر تماس فقط سرور چک نهایی باقی می ماند.

نشانی وب مستاجرhttps://downf.io
احراز هویتX-API-Key: pending_activation_…
پروفایل مشتریDownfBridge
نسخه APIv1
# 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 آغاز می‌شود. این نمای سازگاری سپس هیچ بسته‌بندی کلاینتی را در بر ندارد. واقعیت نهایی این است که هیچ لاگ یا مخزن عمومی وجود ندارد.

02

حل یک پیوند

DownF عملیات Resolve را در اطراف تشخیص منبع سازماندهی می کند. نمای سازگاری آن فرمت ها را از یک URL ارسال شده مقایسه می کند. هیچ خروجی اختراع شده ای چک نهایی باقی نمی ماند.

پست/v1/resolveدامنه: حل
فیلدنوعلازم استشرح
media_addressنشانی وب HTTPSبلهصفحه رسانه های عمومی یا مجاز برای تجزیه و تحلیل.
tenantرشتهنهدامنه مستاجر اختصاص داده شده.معمولا حذف می شود.
{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

شناسه فرمت با مقدار بازگشتی بدون تغییر روی DownF آغاز می شود. این نمای سازگاری سپس در دسترس بودن بر اساس پیوند را ارائه می دهد. حقیقت نهایی هیچ برچسب کیفیت حدس زده شده ای نیست.

03

ایجاد و پیگیری یک کار دانلود

ایجاد شغل با آماده سازی غیرهمزمان در DownF شروع می شود.نمای بعدی یک درخواست HTTP کوتاه را پوشش می دهد.صفحه اجرای کارگر محدود را قابل مشاهده نگه می دارد.

پست/v1/jobsحوزه: مشاغل
فیلدنوعلازم استشرح
media_addressنشانی وب HTTPSبلههمان منبع نرمال شده ارائه شده برای حل.
output_refرشتهبلهیک شناسه دقیق از پاسخ حل.
tenantرشتهنهدامنه مستاجر اختصاص داده شده.معمولا حذف می شود.
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"}'
1202 پذیرفته شدذخیره transfer_ref.
2وضعیت نظرسنجیGET /v1/jobs/{transfer_ref} با همان کلید
3آمادهآدرس دانلود امضا شده را باز کنید.
وضعیتمعنیعمل مشتری
queuedپذیرفته شده در صف محدود شدهدوباره با عقب نشینی نظرسنجی کنید.
extractingبازسازی متادیتا یا مسیر منبعبه نظر سنجی ادامه دهید.
processingدانلود کردن، ریماکس کردن یا ادغام کردننمایش پیشرفت سرور
readyدانلود امضا شده در دسترس است.آدرس را برای کاربر ارسال کنید.
failedخطای ساختاری ترمینالخوانده شده error_code.فقط در صورت توصیه دوباره سعی کنید
expiredخروجی موقت حذف شد.ایجاد یک شغل جدید
curl https://downf.io/v1/jobs/TRANSFER_REF \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN"

دیدگاه سازگاری DownF یک ثانیه انتظار اولیه را برای رأی گیری Job بررسی می کند.این نشان می دهد capped backoff بعدی و مخفی نمی کند تحویل موقت امضا شده.

04

خطاهای قابل پیش بینی

DownF سه نکته عملی برای قرارداد خطا ارائه می‌دهد. ابتدا یک پاکت غیر 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": "…"
}
انتقال ابرمتنمعنی معمولکنش
400URL نامعتبر، بدنه یا فرمت در دسترس نیست.درخواست را اصلاح کنید.برای فرمت ها دوباره حل کنید.
401کلید گمشده، نامعتبر، منقضی شده یا با دامنه اشتباه.اعتبار جانبی سرور را بررسی کنید.
403مستاجر یا منبع سیاست درخواست را رد کرد.از سیاست دور نشوید با پشتیبانی تماس بگیرید
404شغل نامعلوم یا منقضی شدهدر صورت لزوم یک شغل جدید ایجاد کنید.
429درخواست یا حد فعال-کار رسیده است.افتخار retry_after_seconds.
503صف / ظرفیت یا بالادست به طور موقت در دسترس نیست.دوباره با عقب نشینی نمایی و جیتر سعی کنید.
05

قرارداد عملیاتی

DownF پس از بررسی مشتری مورد نظر، سقف درخواست را اختصاص می دهد، بررسی های سازگاری خود را حفظ می کند و ارائه دهندگان بالادستی را پایدار می کند.

DownF دسترسی Schema را در اطراف فعال سازی قبل از کاوش سازماندهی می کند.نمایش سازگاری آن، احراز هویت اختصاص داده شده را مقایسه می کند.شکل های درخواست مستند شده، چک نهایی باقی می ماند.

دسترسی بازبینی شده توسط اپراتور

فعال سازی از طریق پشتیبانی

محصول را توصیف کنید، تماس‌های ماهانه پیش‌بینی‌شده را ارائه دهید و پلتفرم‌هایی را که باید تحلیل کند فهرست کنید. پشتیبانی DownF دامنه‌های مورد نیاز را قبل از صدور یک اعتبارنامه یک‌بار مصرف قابل مشاهده که نسخه ذخیره‌شده آن فقط یک هش است، تأیید خواهد کرد.

درخواست فعال سازی کلیدها محدوده مستاجر، قابل لغو و از طریق فرم تماس صادر می شوند.اسکریپت های ناشناس نمی توانند کار دانلودر را اجرا کنند.