Faqat oldindan ko‘rish — faollashtirish talab qilinadi

downf.io bilan yuklab olishlarni qurish

DownF operator moslik qo‘llanilish holatini ko‘rib chiqmaguncha API bajarilishini o‘chirib qo‘yadi. Misollar rejalashtirilgan shartnomani tasvirlaydi, haqiqiy ma’lumotlar va kvotalar faqat qo‘llab-quvvatlash faollashtirilishi orqali keladi.

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

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

DownF API mezbonini qo'llab-quvvatlash faollashtirilgan kredentiallar atrofida tashkil etadi. Uning moslik ko'rinishi tayinlangan ijarachi endpointini solishtiradi. Faqat server chaqiruv yo'li oxirgi tekshiruv sifatida qoladi.

Ижарачи URL'сиhttps://downf.io

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

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

API версиясиv1

# 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"}'

Kredential xavfsizligi DownF server tomonidagi maxfiy saqlashdan boshlanadi. Ushbu moslik ko‘rinishi mijoz paketining biriktirilishini ko‘rsatmaydi. Yakuniy haqiqat shundaki, hech qanday jamoat jurnallari yoki omborlari yo‘q.

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

DownF manba aniqlash atrofida hal qilish operatsiyasini tashkil etadi. Uning moslashuvchanlik ko'rinishi bir topshirilgan URL manzilidan formatlarni taqqoslaydi. Hech qanday ixtiro qilingan chiqishlar oxirgi tekshiruv bo'lib qoladi.

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

Майдон	Тури	Талаб қилинади	Таърифи
`media_address`	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 DownF da o'zgarmagan qaytgan qiymat bilan boshlanadi. Ushbu moslik ko'rinishi keyin har bir havola mavjudligini taqdim etadi. Oxirgi fakt - taxmin qilingan sifat yorlig'i yo'q.

Yuklab olish ishini yarating va kuzatib boring

Ish yaratish DownF da asynchronous tayyorgarlik bilan boshlanadi. Keyingi ko'rinish qisqa HTTP so'rovini qamrab oladi. Sahifa chegaralangan ishchi ijrosini ko'rinadigan qilib saqlaydi.

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

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

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ТайёрИмзоланган 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://downf.io/v1/jobs/TRANSFER_REF \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN"

DownF moslik ko'rinishi Ish so'rovi uchun bir soniyalik dastlabki kutishni ko'rib chiqadi. U keyingi cheklangan orqaga chekinishni ko'rsatadi va vaqtinchalik imzolangan yetkazib berishni yashirmaydi.

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

DownF xato shartnomasi uchun uchta amaliy nuqtani taqdim etadi. Birinchi navbatda, bitta 2xx bo'lmagan konvert mavjud. Moslik ko'rinishi keyin qo'llab-quvvatlash so'rovi ID sini qamrab oladi. Uning oxirgi nuqtasi esa oldindan aytib bo'ladigan mijozni boshqarishdir.

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

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

DownF, uning mos kelish tekshiruvlarini va yuqori manba provayderlarini barqaror saqlab, mo'ljallangan mijozni ko'rib chiqqandan so'ng, so'rov tavanini tayinlaydi.

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.

DownF Schema ga kirishni faollashtirish atrofida tashkil qiladi, so'ngra o'rganish. Uning moslik ko'rinishi tayinlangan autentifikatsiyani solishtiradi. Hujjatlangan so'rov shakllari yakuniy tekshiruvda qoladi.

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

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

Mahsulotni ta’riflang, uning oylik qo‘ng‘iroqlarini oldindan ayting va tahlil qilinishi kerak bo‘lgan platformalarni sanab bering. DownF qo‘llab-quvvatlashi talab qilinadigan doiralarni tasdiqlaydi va faqat xesh sifatida saqlanadigan bir martalik ko‘rinadigan guvohnomani beradi.

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