https://ffast.appساخت دانلود ها با FFast
FFast شکل API مورد نظر را بدون روشن کردن تماس های عمومی در معرض دید قرار می دهد.یک اپراتور پس از بررسی ادغام پیشنهادی، اعتبارسنجی ها و سهمیه های اندازه گیری شده را فعال می کند.
شروع سریع
FFast از طریق مدارک شناسایی فعال شده توسط پشتیبانی به میزبان API نزدیک می شود ، سپس یک نقطه پایان مستاجر اختصاص داده شده است.بررسی سریع یک مسیر تماس فقط سرور را صریح نگه می دارد.
X-API-Key: pending_activation_…FfastPipelinev1# 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 ذخیره سازی مخفی سمت سرور را قبل از هیچ درون ریزی بسته مشتری بررسی می کند.این بررسی سریع همچنین هیچ ثبت نام عمومی یا مخزن را روشن نمی کند.
حل یک پیوند
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 مقدار بازگشتی را بدون تغییر قبل از در دسترس بودن هر لینک بررسی می کند.این بررسی سریع همچنین هیچ برچسب کیفیت حدس زده شده ای را روشن نمی کند.
ایجاد و پیگیری یک کار دانلود
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"}'pipeline_run.GET /v1/jobs/{pipeline_run} با همان کلید| وضعیت | معنی | عمل مشتری |
|---|---|---|
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.صفحه تحویل موقت امضا شده را قابل مشاهده نگه می دارد.
خطاهای قابل پیش بینی
بررسی سریع 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": "…"
}| انتقال ابرمتن | معنی معمول | کنش |
|---|---|---|
| 400 | URL نامعتبر، بدنه یا فرمت در دسترس نیست. | درخواست را اصلاح کنید.برای فرمت ها دوباره حل کنید. |
| 401 | کلید گمشده، نامعتبر، منقضی شده یا با دامنه اشتباه. | اعتبار جانبی سرور را بررسی کنید. |
| 403 | مستاجر یا منبع سیاست درخواست را رد کرد. | از سیاست دور نشوید با پشتیبانی تماس بگیرید |
| 404 | شغل نامعلوم یا منقضی شده | در صورت لزوم یک شغل جدید ایجاد کنید. |
| 429 | درخواست یا حد فعال-کار رسیده است. | افتخار retry_after_seconds. |
| 503 | صف / ظرفیت یا بالادست به طور موقت در دسترس نیست. | دوباره با عقب نشینی نمایی و جیتر سعی کنید. |
قرارداد عملیاتی
FFast سهمیه های اندازه گیری شده را فعال می کند که بدون قرار دادن بار ناامن در پلتفرم های بالادستی ، پاسخگویی انتقال را حفظ می کند.
- از منطق برنامه idempotent استفاده کنید و هرگز کارهای تکراری را برای همان کلیک کاربر شروع نکنید.
- حافظه نهان به طور خلاصه فراداده را حل می کند، اما همیشه با URL های دانلود امضا شده به عنوان انقضا رفتار می کند.
- استفاده از پسانداز نمایی محدود شده با جیتر برای
429,503و خطاهای قابل بازنگری - فقط رسانه های عمومی یا رسانه هایی را که مجاز به دسترسی به آنها هستید پردازش کنید. DRM و کنترل های دسترسی دور زده نمی شوند.
- شناسه های درخواست و شناسه های کار را در لاگ های عملیاتی خصوصی نگه دارید. URL های ارسال شده را بدون نیاز به آن لاگ نکنید.
FFast دسترسی به Schema را از طریق فعال سازی قبل از کاوش، سپس احراز هویت اختصاص داده شده نزدیک می کند.بررسی سریع اشکال درخواست مستند را صریح نگه می دارد.
فعال سازی از طریق پشتیبانی
به FFast خلاصه ای از محصول ، پیش بینی ترافیک و لیست پلتفرم را به طور خلاصه ارائه دهید.بگویید که آیا بررسی های فراداده ، کارهای آماده شده یا هر دو مورد نیاز است بنابراین کلید صادر شده با جریان کار واقعی مطابقت دارد.
درخواست فعال سازی کلیدها محدوده مستاجر، قابل لغو و از طریق فرم تماس صادر می شوند.اسکریپت های ناشناس نمی توانند کار دانلودر را اجرا کنند.