Pralihat sahaja — pengaktifan diperlukan

Bina muat turun dengan QuickT

QuickT dokumen bagaimana pelanggan mudah alih akan berkomunikasi dengan perkhidmatan. Ia tidak boleh mengemukakan kerja pengeluaran sehingga sokongan meluluskan reka bentuk dan membolehkan akses yang diskopkan.

QuicktRouteJSON melalui HTTPSTugas asinkronPengenalan yang diskopkan

Mulakan dengan cepat

Untuk hos API, QuickT menyemak kelayakan yang diaktifkan sokongan sebelum titik akhir penyewa yang ditugaskan. Pandangan siap peranti ini juga membuat laluan panggilan pelayan sahaja jelas.

URL Penyewahttps://quickt.io

PengesahanX-API-Key: pending_activation_…

Profil PelangganQuicktRoute

Versi APIv1

# 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 mengatur keselamatan Kredensial di sekitar penyimpanan rahsia sisi pelayan. Paparan sedia peranti tidak membandingkan sebarang penyematan bundel klien. Tiada log awam atau repositori kekal sebagai pemeriksaan akhir.

Menyelesaikan pautan

Untuk operasi Resolve, QuickT memeriksa pengesanan sumber sebelum format dari satu URL yang dikemukakan. Pandangan siap peranti ini juga membuat tidak ada keluaran yang dicipta jelas.

POST/v1/resolveSkop: menyelesaikan

Medan	Jenis	Diperlukan	Huraian
`route_source`	URL HTTPS	Ya	Halaman media awam atau yang dibenarkan untuk dianalisis.
`tenant`	rentetan	Tidak	Domain penyewa yang ditugaskan. Biasanya ditinggalkan.

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

QuickT mengatur Pengenal Format mengelilingi nilai yang dikembalikan tanpa perubahan. Paparan sedia perantinya membandingkan ketersediaan per pautan. Tiada label kualiti yang dianggarkan kekal sebagai pemeriksaan terakhir.

Cipta dan ikuti kerja muat turun

Untuk menerangkan Penciptaan Kerja, QuickT memisahkan persediaan asynchronous dari permintaan HTTP pendek. Pandangan siap peranti memberikan pelaksanaan pekerja yang dibatasi tempatnya sendiri.

POST/v1/jobsSkop: pekerjaan

Medan	Jenis	Diperlukan	Huraian
`route_source`	URL HTTPS	Ya	Sumber yang sama dinormalisasi dihantar untuk menyelesaikan.
`route_format`	rentetan	Ya	ID yang tepat dari respons penyelesaian.
`tenant`	rentetan	Tidak	Domain penyewa yang ditugaskan. Biasanya ditinggalkan.

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 DiterimaSimpan route_job.

2Status undianGET /v1/jobs/{route_job} dengan kunci yang sama.

3SediaBuka URL muat turun yang ditandatangani.

Status	Makna	Tindakan Pelanggan
`queued`	Dibenarkan masuk ke barisan yang dibatasi.	Poll lagi dengan backoff.
`extracting`	Menyegar semula metadata sumber atau laluan.	Teruskan mengundi.
`processing`	Memuat turun, remuxing atau menggabungkan.	Papar kemajuan pelayan.
`ready`	Muat turun yang ditandatangani tersedia.	Hantar URL kepada pengguna.
`failed`	Ralat berstruktur terminal.	Baca `error_code`. Cuba semula hanya apabila dinasihatkan.
`expired`	Keluaran sementara dikeluarkan.	Cipta pekerjaan baru.

curl https://quickt.io/v1/jobs/ROUTE_JOB \
  -H "X-API-Key: $QUICKT_ROUTE_TOKEN"

Tunggu awal selama satu saat adalah titik permulaan untuk peninjauan Tugas pada QuickT. Paparan sedia peranti kemudian mempersembahkan penangguhan terhad dan menerangkan penghantaran bertandatangan sementara.

Kesalahan yang boleh diramalkan

Untuk kontrak Ralat, QuickT bermula dengan satu sampul bukan 2xx. Paparan sedia peranti ini memadankan itu dengan ID permintaan sokongan dan berakhir dengan pengendalian klien yang boleh diramalkan.

{
  "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	Makna biasa	Tindakan
400	URL tidak sah, badan atau format tidak tersedia.	Betulkan permintaan. Selesaikan lagi untuk format.
401	Kunci hilang, tidak sah, tamat tempoh atau salah skop.	Semak kelayakan sisi pelayan.
403	Polisi penyewa atau sumber menolak permintaan.	Jangan mengelirukan dasar Hubungi sokongan.
404	Kerja yang tidak diketahui atau tamat tempoh.	Buat kerja baru jika sesuai.
429	Permintaan atau had aktif-kerja telah dicapai.	Kehormatan `retry_after_seconds`.
503	Baris gilir/kapasiti atau upstream tidak tersedia buat sementara waktu.	Cuba lagi dengan backoff eksponen dan jitter.

Kontrak operasi

QuickT memilih had klien mudah alih semasa kelulusan supaya rangkaian pencipta dan API kekal responsif.

Gunakan logik aplikasi idempotent dan jangan pernah memulakan kerja berganda untuk klik pengguna yang sama.
Cache menyelesaikan metadata secara ringkas, tetapi sentiasa merawat URL muat turun yang ditandatangani sebagai tamat tempoh.
Gunakan backoff eksponen yang dibatasi dengan jitter untuk 429, 503 dan kesilapan yang boleh dicuba semula.
Proses hanya media awam atau media yang anda dibenarkan untuk mengakses. DRM dan kawalan akses tidak dipintas.
Simpan ID permintaan dan ID kerja dalam log operasi peribadi. Jangan log URL yang dihantar tanpa perlu.

Untuk akses Skema, QuickT memeriksa pengaktifan sebelum penerokaan sebelum pengesahan yang ditetapkan. Paparan sedia peranti ini juga menjelaskan bentuk permintaan yang didokumenkan.

AKSESS YANG DIPERIKSA OPERASI

Aktifkan melalui sokongan

Terangkan pengalaman mudah alih, jangkaan trafiknya dan rangkaian pencipta yang diperlukan. QuickT menggunakan maklumat itu untuk menetapkan analisis dan kebenaran barisan sebelum mendedahkan rahsia sekali.

Minta pengaktifan Kunci adalah skop penyewa, boleh dibatalkan dan dikeluarkan melalui borang Hubungi. Skrip tanpa nama tidak dapat melaksanakan kerja pemuat turun.