https://ffast.appFFast bilan yuklab olishlarni qurish
FFast mo'ljallangan API shaklini jamoat chaqiruvlarini yoqmasdan ochib beradi. Operator taklif qilingan integratsiyani ko'rib chiqqandan so'ng credential va o'lchangan kvotalarni faollashtiradi.
FfastPipelineHTTPS орқали JSONАсинхрон ишларМинтақага оид ишончномалар
01
Тезкор бошланиш
FFast API mezboniga qo'llab-quvvatlash faollashtirilgan kredensiallar orqali, so'ngra tayinlangan ijarachi endpointi orqali murojaat qiladi. Tezkor ko'rib chiqish faqat server chaqiruv yo'lini aniq saqlaydi.
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"}'FFast Credential xavfsizligi uchun mijoz paketini joylashtirishdan oldin server tomonidagi maxfiy saqlashni tekshiradi. Ushbu tezkor ko'rib chiqish hech qanday jamoat jurnallari yoki omborlarni tozalamaydi.
02
Уланишни ҳал қилиш
FFast manba aniqlash orqali Resolve operatsiyasiga yondashadi, so'ngra bitta yuborilgan URL manzilidan formatlaydi. Tezkor ko'rib chiqish hech qanday ixtiro qilingan natijalarni aniq saqlamaydi.
ПОСТ
/v1/resolveМинтақа: ҳал қилиш| Майдон | Тури | Талаб қилинади | Таърифи |
|---|---|---|---|
fast_source | HTTPS URL | Ҳа | Таҳлил қилиш учун жамоат ёки ваколатли ОАВ саҳифаси. |
tenant | сатр | Йўқ | Belgilanadigan ijarachi domeni. Odatda o'tkazib yuboriladi. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}Format identifikatori uchun FFast bog'lanish mavjudligidan oldin qaytarilgan qiymatni o'zgarmagan holda tekshiradi. Ushbu tezkor ko'rib chiqish taxmin qilingan sifat yorlig'ini ham aniq ko'rsatmaydi.
03
Yuklab olish ishini yarating va kuzatib boring
FFast ish yaratishni asinxron tayyorgarlikni birinchi aniqlash orqali boshqaradi. U qisqa HTTP so'rovi bilan davom etadi va chegaralangan ishchi bajarilishini nazorat qiladi.
ПОСТ
/v1/jobsКўрсаткич: иш ўринлари| Майдон | Тури | Талаб қилинади | Таърифи |
|---|---|---|---|
fast_source | HTTPS URL | Ҳа | Hal qilish uchun bir xil normallashtirilgan manba taqdim etildi. |
output_code | сатр | Ҳа | Aniq ID resolve javobidan olingan. |
tenant | сатр | Йўқ | Belgilanadigan ijarachi domeni. Odatda o'tkazib yuboriladi. |
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 | Cheklangan navbatga qabul qilindi. | Овоз беришни яна бир бор ортга қайтариш билан. |
extracting | Manba metama'lumotlari yoki yo‘l yangilanmoqda. | Сўровнома ўтказишни давом эттиринг. |
processing | Юклаб олиш, ремукс ёки бирлаштириш. | Сервернинг ишлаш жараёнини кўрсатиш. |
ready | Имзоланган юклаб олиш мавжуд. | URL-манзилни фойдаланувчига юборинг. |
failed | Terminalda tuzilgan xato. | Ўқиш error_code. Faqat tavsiya qilinganda qayta urinib ko'ring. |
expired | Вақтинчалик чиқариб ташланди. | Янги иш ўрни яратиш. |
curl https://ffast.app/v1/jobs/PIPELINE_RUN \
-H "X-API-Key: $FFAST_PIPELINE_KEY"Ish so'rovi FFast da bir soniyalik dastlabki kutish bilan boshlanadi. Keyingi ko'rinish cheklangan orqaga chekinishni qamrab oladi. Sahifa vaqtinchalik imzolangan yetkazib berishni ko'rinishda saqlaydi.
04
Тахмин қилинадиган хатолар
FFast tezkor ko'rib chiqishi Error shartnomasi uchun bitta non-2xx konvertni ko'rib chiqadi. U keyingi qo'llab-quvvatlash so'rovi ID sini ko'rsatadi va oldindan aytib bo'ladigan mijozni boshqarishni yashirmaydi.
{
"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": "…"
}| HTTP | Одатда маъноси | Амал |
|---|---|---|
| 400 | Нотўғри URL, танаси ёки мавжуд бўлмаган формат. | So'rovni to'g'rilang. Formatlar uchun qayta hal qiling. |
| 401 | Yo'qolgan, noto'g'ri, muddati o'tgan yoki noto'g'ri doiradagi kalit. | Server tomonidagi autentifikatsiyani tekshiring. |
| 403 | Ijaraчи yoki manba siyosati so'rovni rad etdi. | Siyosatni chetlab o'tmang. Qo'llab-quvvatlash bilan bog'laning. |
| 404 | Noma'lum yoki muddati o'tgan ish. | Agar kerak bo‘lsa, yangi ish yaratish. |
| 429 | So‘rov yoki faol ish limiti oshdi. | Иззат retry_after_seconds. |
| 503 | Навбат/қувват ёки юқорига вақтинчалик етиб бўлмайди. | Eksponensial orqaga chekinish va tebranish bilan qayta urinib ko'ring. |
05
Ишлаб чиқариш шартномаси
FFast xavfsiz bo'lmagan yukni yuqori platformalarga yuklamasdan, uzatishni javobgar qiladigan o'lchangan kvotalarni faollashtiradi.
- idempotent dastur mantiqidan foydalaning va hech qachon bir xil foydalanuvchi bosimi uchun takrorlanadigan ishlarni boshlamang.
- Кэш метамаълумотларни қисқача ҳал қилади, lekin har doim imzolangan yuklab olish URL-manzillarini tugaydigan deb hisoblaydi.
- Jitter bilan chegaralangan eksponensial orqaga chekinishni qo'llang
429,503ва қайта уриниш хатолари. - Faqat jamoatchilik mediasi yoki siz kirish huquqiga ega bo'lgan mediani qayta ishlash. DRM va kirish nazorati chetlab o'tmaydi.
- So'rov ID va ish IDlarini shaxsiy operatsion jurnallarda saqlang. Berilgan URL manzillarini keraksiz ravishda yozmang.
FFast Shema kirishiga faollashtirish orqali kiradi, so'ngra tayinlangan autentifikatsiya orqali. Tezkor ko'rib chiqish hujjatlashtirilgan so'rov shakllarini aniq saqlaydi.
Ёрдам орқали фаоллаштириш
FFast ga qisqacha mahsulot ta'rifi, trafik prognozi va platformalar ro'yxatini bering. Metama'lumot tekshiruvlari, tayyorlangan ishlar yoki ikkalasi ham kerakligini ayting, shunda berilgan kalit haqiqiy ish jarayoniga mos keladi.
Фаоллаштиришни сўранг Kalitlar ijarachi doirasida, bekor qilinishi mumkin va aloqa shakli orqali beriladi Anonim sxemalar yuklab oluvchi ishini bajarolmaydi.