Faqat oldindan ko‘rish — faollashtirish talab qilinadi

QuickT bilan yuklab olishlarni qurish

QuickT mobil mijozning xizmat bilan qanday aloqa qilishi haqida hujjatlashtiradi. Qo'llab-quvvatlash dizaynni tasdiqlab, doiraviy kirishni yoqmaguncha ishlab chiqarish ishlarini topshira olmaydi.

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

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

API xosti uchun QuickT tayinlangan ijarachining oxirgi nuqtasi oldida qo'llab-quvvatlash faollashtirilgan ishonchnomalarni tekshiradi. Bu qurilmaga tayyor ko'rinish, shuningdek, faqat serverga chaqiruv yo'lini aniq qiladi.

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

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

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

API версиясиv1

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

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

QuickT Credential xavfsizligini server tomonidagi maxfiy saqlash atrofida tashkil etadi. Uning qurilmaga tayyor ko'rinishi hech qanday mijoz paketini o'z ichiga olmaydi. Hech qanday jamoat jurnallari yoki omborlari yakuniy tekshiruv sifatida qoladi.

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

Resolve operatsiyasi uchun, QuickT bir yuborilgan URL manzildan formatlardan oldin manba aniqlashni tekshiradi. Ushbu qurilmaga tayyor ko'rinish ham ixtiro qilingan chiqishlarni aniq ko'rsatmaydi.

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

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

QuickT qaytarilgan qiymat atrofida Format identifikatorini o'zgarmas holda tashkil qiladi. Uning qurilmaga tayyor ko'rinishi har bir havola mavjudligini taqqoslaydi. Taxmin qilingan sifat yorlig'i yakuniy tekshiruvda qolmaydi.

Yuklab olish ishini yarating va kuzatib boring

Ish yaratishni tushuntirish uchun QuickT asynchronous tayyorgarlikdan qisqa HTTP so'rovidan ajratadi. Qurilmaga tayyor ko'rinish chegaralangan ishchi ijrosiga o'z o'rnini beradi.

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

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

curl -X POST https://quickt.io/v1/jobs \
  -H "X-API-Key: $QUICKT_ROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"route_source":"https://www.youtube.com/watch?v=VIDEO_ID","route_format":"18"}'

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

2Сўровнома ҳолатиGET /v1/jobs/{route_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://quickt.io/v1/jobs/ROUTE_JOB \
  -H "X-API-Key: $QUICKT_ROUTE_TOKEN"

Bir soniyalik dastlabki kutish QuickT da Job so'rovi uchun boshlang'ich nuqtadir. Keyin qurilmaga tayyor ko'rinish qoplangan orqaga qaytishni taqdim etadi va vaqtincha imzolangan yetkazib berishni tushuntiradi.

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

Xato shartnomasi uchun, QuickT bitta 2xx bo'lmagan konvert bilan boshlanadi. Uning qurilmaga tayyor ko'rinishi buni qo'llab-quvvatlash so'rovi ID si bilan juftlashtiradi va oldindan aytib bo'ladigan mijozni boshqarish bilan yakunlanadi.

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

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

QuickT tasdiqlash paytida mobil-mijoz chegaralarini tanlaydi, shuning uchun yaratuvchi tarmoqlari va API javobgar bo'lib qoladi.

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 ga kirish uchun, QuickT tayinlangan autentifikatsiyadan oldin faollashtirishni tekshiradi. Ushbu qurilmaga tayyor ko'rinish, shuningdek, hujjatlashtirilgan so'rov shakllarini aniq qiladi.

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

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

Mobil tajribani, uning trafik kutuvlarini va kerakli yaratuvchi tarmoqlarini tasvirlang. QuickT ushbu ma'lumotlardan tahlil va navbat ruxsatlarini tayinlash uchun foydalanadi, so'ng sirni oshkor qiladi.

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