https://quickt.ioNgawangun unduhan nganggo QuickT
QuickT ngadokumentasikeun kumaha klien mobile bakal komunikasi sareng jasa. Éta henteu tiasa ngirim karya produksi dugi ka dukungan nyatujuan desain sareng ngaktipkeun aksés anu diwatesan.
Mimitian gancang
Pikeun host API, QuickT mariksa kredensial anu diaktipkeun dukungan sateuacan titik akhir panyewa anu ditugaskeun. Témbongkeun alat siap ieu ogé ngajantenkeun jalur telepon server-wungkul jelas.
X-API-Key: pending_activation_…QuicktRoutev1# 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 ngatur kaamanan Kredensial di sakuriling panyimpenan rusiah sisi server. Tampilan siap alat na ngabandingkeun henteu aya embedding bundel klien. Henteu aya log umum atanapi repositori anu tetep janten pamariksaan akhir.
Ngarengsekeun hiji link
Pikeun operasi Resolve, QuickT mariksa deteksi sumber sateuacan format tina hiji URL anu dikintunkeun. Tampilan siap alat ieu ogé ngajelaskeun teu aya keluaran anu diada-adakeun.
/v1/resolveLingkup: ngarengsekeun| Medan | Tipe | Diperyogikeun | Katerangan |
|---|---|---|---|
route_source | URL HTTPS | Leres | Halaman média umum atanapi anu diidinan pikeun dianalisis. |
tenant | string | Henteu | Ditugaskeun domain panyewa. Biasana dileungitkeun. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}QuickT ngatur idéntifikasi Format sabudeureun nilai anu dipulangkeun tanpa robah. Tampilan siap alat na ngabandingkeun kasadiaan per-link. Henteu aya labél kualitas anu ditebak anu tetep janten pamariksaan akhir.
Nyiptakeun sareng nuturkeun padamelan unduhan
Pikeun ngajelaskeun nyiptakeun Job, QuickT misahkeun persiapan asinkron ti pamundut HTTP pondok. Tampilan siap alat masihan palaksanaan pagawé anu diwatesan tempat sorangan.
/v1/jobsLingkup: padamelan| Medan | Tipe | Diperyogikeun | Katerangan |
|---|---|---|---|
route_source | URL HTTPS | Leres | Sumber normalisasi anu sami diserahkeun pikeun direngsekeun. |
route_format | string | Leres | ID anu pasti tina réspon ngarengsekeun. |
tenant | string | Henteu | Ditugaskeun domain panyewa. Biasana dileungitkeun. |
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"}'route_job.GET /v1/jobs/{route_job} kalayan konci anu sami.| Status | Harti | Tindakan klien |
|---|---|---|
queued | Ditampi kana antrian anu diwatesan. | Poll deui sareng backoff. |
extracting | Ngarefresh metadata sumber atanapi rute. | Teruskeun polling. |
processing | Ngaunduh, remuxing atanapi ngahijikeun. | Tampilan kamajuan server. |
ready | Unduh anu ditandatanganan sayogi. | Kirimkeun URL ka pangguna. |
failed | Kasalahan struktur terminal. | Baca error_code. Coba deui ngan ukur nalika disarankeun. |
expired | Kaluaran samentawis dipiceun. | Nyiptakeun padamelan anyar. |
curl https://quickt.io/v1/jobs/ROUTE_JOB \
-H "X-API-Key: $QUICKT_ROUTE_TOKEN"Antosan awal hiji detik nyaéta titik awal pikeun polling Job dina QuickT. Tampilan siap alat lajeng nampilkeun backoff anu diwatesan sarta ngajelaskeun pangiriman ditandatanganan samentawis.
Kasalahan anu tiasa diprediksi
Pikeun kontrak Kasalahan, QuickT ngamimitian ku hiji amplop non-2xx. Tampilan siap alat na ngagabungkeun éta sareng ID pamundut dukungan sarta réngsé ku pangaturan klien anu tiasa diprediksi.
{
"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 | Harti anu khas | Aksi |
|---|---|---|
| 400 | URL anu henteu valid, awak atanapi format anu teu aya. | Ngabenerkeun pamundut. Ngarengsekeun deui pikeun format. |
| 401 | Konci leungit, henteu valid, kadaluarsa atanapi salah-ruang lingkup. | Pariksa kredensial sisi server. |
| 403 | Panyewa atanapi kabijakan sumber nolak pamundut. | Ulah bypass kawijakan. Hubungi rojongan. |
| 404 | Pakaryan anu teu dikenal atanapi kadaluarsana. | Nyiptakeun padamelan énggal upami cocog. |
| 429 | Kéngingkeun atanapi aktip-pakaryan wates ngahontal. | Honor retry_after_seconds. |
| 503 | Antrian/kapasitas atawa upstream keur teu aya samentara. | Coba deui sareng backoff éksponénsial sareng jitter. |
Kontrak operasi
QuickT milih watesan klien mobile nalika persetujuan supados jaringan panyipta sareng API tetep responsif.
- Anggo logika aplikasi idempotent sareng henteu kantos ngamimitian padamelan duplikat pikeun pangguna anu sami klik.
- Cache metadata résolusi sacara singget, tapi sok anggap URL unduhan anu ditandatanganan salaku kadaluwarsa.
- Anggo backoff éksponénsial anu dibatesan sareng jitter pikeun
429,503sareng kasalahan anu tiasa diusahakeun deui. - Ngolah ngan ukur média umum atanapi média anu anjeun diidinan pikeun ngaksés. DRM sareng kontrol aksés henteu dipaliré.
- Ngajaga ID pamundut sareng ID padamelan dina log operasi pribadi. Ulah log URL anu dikirimkeun tanpa perlu.
Pikeun aksés Skéma, QuickT mariksa aktivasi saméméh eksplorasi saméméh oténtikasi anu ditugaskeun. Tampilan siap alat ieu ogé ngajantenkeun bentuk pamundut anu didokumentasikeun jelas.
Aktipkeun ngalangkungan dukungan
Jelaskeun pangalaman mobile, ekspektasi lalulintasna jeung jaringan panyipta anu diperlukeun. QuickT ngagunakeun informasi éta pikeun masihan analisa jeung idin antrian saméméh ngabuka rusiahna.
Kéngingkeun aktivasina Konci téh diwatesan ku panyewa, bisa dibatalkeun jeung dikaluarkeun ngaliwatan formulir Kontak. Skrip anonim teu bisa ngalaksanakeun pagawéan pangunduh.