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

ساخت دانلود ها با FFast

FFast شکل API مورد نظر را بدون روشن کردن تماس های عمومی در معرض دید قرار می دهد.یک اپراتور پس از بررسی ادغام پیشنهادی، اعتبارسنجی ها و سهمیه های اندازه گیری شده را فعال می کند.

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

شروع سریع

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

نشانی وب مستاجرhttps://ffast.app
احراز هویتX-API-Key: pending_activation_…
پروفایل مشتریFfastPipeline
نسخه APIv1
# Available only after support activation
export FFAST_PIPELINE_KEY="issued-after-review"

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

برای ایمنی Credential ، FFast ذخیره سازی مخفی سمت سرور را قبل از هیچ درون ریزی بسته مشتری بررسی می کند.این بررسی سریع همچنین هیچ ثبت نام عمومی یا مخزن را روشن نمی کند.

02

حل یک پیوند

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

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

برای شناسه Format، FFast مقدار بازگشتی را بدون تغییر قبل از در دسترس بودن هر لینک بررسی می کند.این بررسی سریع همچنین هیچ برچسب کیفیت حدس زده شده ای را روشن نمی کند.

03

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

FFast با شناسایی ابتدایی آماده سازی غیر همزمان، ایجاد Job را مدیریت می کند.این با یک درخواست کوتاه HTTP دنبال می شود و اجرای کارگر محدود را در نظر می گیرد.

پست/v1/jobsحوزه: مشاغل
فیلدنوعلازم استشرح
fast_sourceنشانی وب HTTPSبلههمان منبع نرمال شده ارائه شده برای حل.
output_codeرشتهبلهیک شناسه دقیق از پاسخ حل.
tenantرشتهنهدامنه مستاجر اختصاص داده شده.معمولا حذف می شود.
curl -X POST https://ffast.app/v1/jobs \
  -H "X-API-Key: $FFAST_PIPELINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fast_source":"https://www.youtube.com/watch?v=VIDEO_ID","output_code":"18"}'
1202 پذیرفته شدذخیره pipeline_run.
2وضعیت نظرسنجیGET /v1/jobs/{pipeline_run} با همان کلید
3آمادهآدرس دانلود امضا شده را باز کنید.
وضعیتمعنیعمل مشتری
queuedپذیرفته شده در صف محدود شدهدوباره با عقب نشینی نظرسنجی کنید.
extractingبازسازی متادیتا یا مسیر منبعبه نظر سنجی ادامه دهید.
processingدانلود کردن، ریماکس کردن یا ادغام کردننمایش پیشرفت سرور
readyدانلود امضا شده در دسترس است.آدرس را برای کاربر ارسال کنید.
failedخطای ساختاری ترمینالخوانده شده error_code.فقط در صورت توصیه دوباره سعی کنید
expiredخروجی موقت حذف شد.ایجاد یک شغل جدید
curl https://ffast.app/v1/jobs/PIPELINE_RUN \
  -H "X-API-Key: $FFAST_PIPELINE_KEY"

رای گیری شغل با یک ثانیه انتظار اولیه در FFast آغاز می شود.نمای بعدی پوشش داده شده است capped backoff.صفحه تحویل موقت امضا شده را قابل مشاهده نگه می دارد.

04

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

بررسی سریع FFast یک پاکت غیر 2xx را برای قرارداد Error بررسی می کند.این یک شناسه درخواست پشتیبانی را در ادامه نشان می دهد و مدیریت قابل پیش بینی مشتری را مخفی نمی کند.

{
  "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

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

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

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

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

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

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

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