Faqat oldindan ko‘rish — faollashtirish talab qilinadi

EasyF bilan yuklamalarni yarating

EasyF interfeysni oldindan ko'rsatadi, shunda dasturchilar o'z ishlarini baholay oladi. Jonli kalit va foydalanish chegarasi mavjud bo'lishidan oldin qo'llab-quvvatlash ko'rib chiqilishi talab qilinadi.

EasyfClientHTTPS орқали JSONАсинхрон ишларМинтақага оид ишончномалар

Тезкор бошланиш

API mezbonini tushuntirish uchun EasyF qo'llab-quvvatlash faollashtirilgan credentiallarni tayinlangan ijarachi endpointidan ajratadi. Oddiy til bilan ishlash jarayoni faqat server chaqiruv yo'liga o'z joyini beradi.

Ижарачи URL'сиhttps://easyf.app

Тасдиқдан ўтказишX-API-Key: pending_activation_…

Мижознинг профилиEasyfClient

API версиясиv1

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

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

Credential xavfsizligi EasyF da server tomonida maxfiy saqlashdan boshlanadi. Keyingi ko'rinishda mijoz paketining joylashtirilmasligi ko'rsatilgan. Sahifa hech qanday jamoat jurnallari yoki omborlarni ko'rsatmaydi.

Уланишни ҳал қилиш

Resolve operatsiyasini tushuntirish uchun, EasyF manba aniqlashni formatlardan bitta yuborilgan URL dan ajratadi. Oddiy til bilan ifodalangan ish jarayoni ixtiro qilingan natijalarga o'z joyini bermaydi.

ПОСТ/v1/resolveМинтақа: ҳал қилиш

Майдон	Тури	Талаб қилинади	Таърифи
`asset_url`	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 EasyF da qaytariladigan qiymat o'zgarmagan holda boshlanadi. Keyingi ko'rinish har bir havola uchun mavjudlikni qamrab oladi. Sahifa hech qanday taxmin qilingan sifat yorlig'ini ko'rinadigan qilib saqlaydi.

Yuklab olish ishini yarating va kuzatib boring

EasyF ish o'rinlari yaratish uchun uchta amaliy nuqtani taqdim etadi. Birinchisi - asinxron tayyorgarlik. Oddiy til bilan ishlash jarayoni qisqa HTTP so'rovini qamrab oladi. Uning oxirgi nuqtasi chegaralangan ishchi bajarilishi.

ПОСТ/v1/jobsКўрсаткич: иш ўринлари

Майдон	Тури	Талаб қилинади	Таърифи
`asset_url`	HTTPS URL	Ҳа	Hal qilish uchun bir xil normallashtirilgan manba taqdim etildi.
`variant_code`	сатр	Ҳа	Aniq ID resolve javobidan olingan.
`tenant`	сатр	Йўқ	Belgilanadigan ijarachi domeni. Odatda o'tkazib yuboriladi.

curl -X POST https://easyf.app/v1/jobs \
  -H "X-API-Key: $EASYF_SERVICE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID","variant_code":"18"}'

1202 Қабул қилиндиСақлаш delivery_id.

2Сўровнома ҳолатиGET /v1/jobs/{delivery_id} бир хил калит билан.

3ТайёрИмзоланган yuklab olish URL-манзилини ochish.

Ҳолат	Маъноси	Мижознинг ҳаракати
`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://easyf.app/v1/jobs/DELIVERY_ID \
  -H "X-API-Key: $EASYF_SERVICE_KEY"

EasyF ish so'rovini bir soniyalik dastlabki kutish orqali, keyin esa chegaralangan orqaga chekinish bilan amalga oshiradi. Oddiy til bilan ifodalangan ish jarayoni vaqtinchalik imzolangan yetkazib berishni aniq qiladi.

Тахмин қилинадиган хатолар

EasyF Xato shartnomasini bitta 2xx bo'lmagan konvert atrofida tashkil qiladi. Uning oddiy til bilan ishlash jarayoni qo'llab-quvvatlash so'rovi ID sini solishtiradi. Bashorat qilinadigan mijozni boshqarish oxirgi tekshiruv bo'lib qoladi.

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

Ишлаб чиқариш шартномаси

EasyF har bir tasdiqlangan mahsulot bilan oldindan aytib bo'lmaydigan yo'naltirilgan ish oqimini saqlash uchun amaliy foydalanish chegaralarini kelishadi.

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.

Schema kirishini tushuntirish uchun, EasyF faollashtirishni o‘rganishdan oldin ajratadi va tayinlangan autentifikatsiyani ajratadi. Oddiy til bilan ishlash jarayoni hujjatlashtirilgan so‘rov shakllariga o‘z o‘rnini beradi.

ОПЕРАТОР ТАКРОРЛАГАН КИРУВ

Ёрдам орқали фаоллаштириш

EasyF ga nima qurayotganingizni, API ni qanchalik tez-tez chaqirishingizni va qaysi provayderlar muhimligini ayting. Ko‘rib chiqish ruxsat etilgan amallarni belgilaydi, so‘ngra faqat bir marta credentialni ochib, faqat uning xavfsiz xulosasini saqlaydi.

Фаоллаштиришни сўранг Kalitlar ijarachi doirasida, bekor qilinishi mumkin va aloqa shakli orqali beriladi Anonim sxemalar yuklab oluvchi ishini bajarolmaydi.