Faqat oldindan ko‘rish — faollashtirish talab qilinadi

QuickDL bilan yuklab olishlarni yarating

QuickDL ishlab chiquvchilarga faollashtirishdan oldin zich so'rov modelini tekshirishga imkon beradi. Qo'llab-quvvatlash maxfiy kalit va kvotadan foydalanish mumkin bo'lishidan oldin mahsulotni tasdiqlashi kerak.

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

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

QuickDL da API mezbonini tushuntirishda birinchi o'rinda qo'llab-quvvatlash faollashtirilgan ma'lumotlar keladi. Ushbu ixcham yordamchi dastur belgilangan ijarachi tugun nuqtasi bilan davom etadi va faqat server chaqiruv yo'li bilan yakunlanadi.

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

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

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

API версиясиv1

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

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

QuickDL Credential xavfsizligini server tomonidagi maxfiy saqlashni birinchi bo'lib aniqlash orqali boshqaradi. U hech qanday mijoz paketini o'z ichiga olmaydi va hech qanday jamoat jurnallari yoki omborlarni ko'rinishda saqlamaydi.

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

QuickDL da manba aniqlash Resolve operatsiyasini tushuntirishda birinchi o'rinda turadi. Ushbu ixcham yordamchi bitta yuborilgan URL manzildagi formatlarni ko'rsatadi va ixtiro qilingan chiqishlarsiz yakunlanadi.

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

Майдон	Тури	Талаб қилинади	Таърифи
`public_link`	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
}

QuickDL Format identifikatorini qaytarilgan qiymatni o‘zgarmas holda aniqlash bilan boshqaradi. U keyin har bir havola mavjudligini tekshiradi va taxminiy sifat yorlig‘ini ko‘rsatmaydi.

Yuklab olish ishini yarating va kuzatib boring

QuickDL ning kompakt foydaliligi Job yaratish uchun asynchronous tayyorgarlikni ko'rib chiqadi. U qisqa HTTP so'rovini keyingi ko'rsatadi va chegaralangan ishchi ijrosini yashirinlashtirmaydi.

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

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

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

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

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

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://quickdl.app/v1/jobs/QUICK_JOB \
  -H "X-API-Key: $QUICKDL_JOB_KEY"

QuickDL Ish so'rovi uchun uchta amaliy nuqtani taqdim etadi. Birinchi navbatda bir soniyalik dastlabki kutish mavjud. Kompakt yordamchi keyin cheklangan orqaga qaytishni qamrab oladi. Uning oxirgi nuqtasi vaqtinchalik imzolangan yetkazib berishdir.

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

QuickDL xatolik shartnomasiga bitta 2xx bo'lmagan konvert orqali, so'ngra qo'llab-quvvatlash so'rovi IDsi orqali yaqinlashadi. Kompakt yordamchi dastur mijozni boshqarishni aniq va oldindan aytib berilgan holda saqlaydi.

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

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

QuickDL manba xizmatlarini beqarorlashtirmasdan integratsiyani qo‘llab-quvvatlaydigan kompakt, mijozga xos kvota beradi.

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.

QuickDL da, Schema ga kirishni tushuntirishda tadqiqotdan oldin faollashtirish birinchi o'rinda turadi. Ushbu ixcham vosita tayinlangan autentifikatsiya bilan davom etadi va hujjatlashtirilgan so'rov shakllari bilan yakunlanadi.

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

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

QuickDL ga integratsiya nomi, kutilayotgan oylik hajm va talab qilinadigan manbalarni taqdim eting. Server bajaradigan operatsiyalarni aniqlang, shunda tasdiqlash tor doiradagi, bir martalik kalitni yaratadi.

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