Pratinjau saja — aktivasi diperlukan

Bangun unduhan dengan QuickT

QuickT mendokumentasikan bagaimana klien seluler akan berkomunikasi dengan layanan. Ia tidak dapat menyerahkan pekerjaan produksi sampai dukungan menyetujui desain dan mengaktifkan akses yang dijangkau.

QuicktRouteJSON melalui HTTPSTugas asinkronKredensial yang dijangkau

Awal yang cepat

Untuk host API, QuickT memeriksa kredensial yang diaktifkan dukungan sebelum titik akhir tenant yang ditugaskan. Tampilan siap perangkat ini juga membuat jalur panggilan server saja jelas.

URL Tenanthttps://quickt.io

OtentikasiX-API-Key: pending_activation_…

Profil klienQuicktRoute

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 keamanan Credential di sekitar penyimpanan rahasia sisi server. Tampilan siap perangkatnya membandingkan tidak ada penempatan bundle klien. Tidak ada log publik atau repositori yang tetap menjadi pemeriksaan terakhir.

Menyelesaikan sebuah tautan

Untuk operasi Resolve, QuickT memeriksa deteksi sumber sebelum format dari satu URL yang diajukan. Tampilan siap perangkat ini juga membuat tidak ada keluaran yang diciptakan jelas.

POST/v1/resolveScope: menyelesaikan

Medan	Jenis	Diperlukan	Deskripsi
`route_source`	URL HTTPS	Ya	Halaman media publik atau resmi untuk dianalisis.
`tenant`	string	Tidak.	Domain penyewa yang ditetapkan. Biasanya dihilangkan.

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

QuickT mengatur Format identifikator sekitar nilai yang dikembalikan tidak berubah. Tampilan siap perangkatnya membandingkan ketersediaan per tautan. Tidak ada label kualitas yang ditebak tetap menjadi pemeriksaan terakhir.

Buat dan ikuti pekerjaan unduhan

Untuk menjelaskan pembuatan Pekerjaan, QuickT memisahkan persiapan asinkron dari permintaan HTTP singkat. Tampilan siap perangkat memberikan eksekusi pekerja terbatas tempatnya sendiri.

POST/v1/jobsLingkup: pekerjaan

Medan	Jenis	Diperlukan	Deskripsi
`route_source`	URL HTTPS	Ya	Sumber yang dinormalisasi sama diajukan untuk diselesaikan.
`route_format`	string	Ya	ID tepat dari respons penyelesaian.
`tenant`	string	Tidak.	Domain penyewa yang ditetapkan. Biasanya dihilangkan.

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 PollGET /v1/jobs/{route_job} dengan kunci yang sama.

3SiapBuka URL unduhan yang ditandatangani.

Status	Artinya	Tindakan klien
`queued`	Diterima ke antrian terbatas.	Poll lagi dengan backoff.
`extracting`	Menyegarkan metadata sumber atau rute.	Lanjutkan polling.
`processing`	Mengunduh, meremux, atau menggabungkan.	Tunjukkan kemajuan server.
`ready`	Unduh yang ditandatangani tersedia.	Kirim URL ke pengguna.
`failed`	Kesalahan struktur terminal.	Baca `error_code`. Coba ulang hanya ketika dianjurkan.
`expired`	Keluaran sementara dihapus.	Buat pekerjaan baru.

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

Satu detik awal menunggu adalah titik awal untuk Job polling pada QuickT. A perangkat siap melihat kemudian menyajikan capped backoff dan menjelaskan pengiriman sementara ditandatangani.

Kesalahan yang dapat diprediksi

Untuk kontrak Error, QuickT dimulai dengan satu amplop non-2xx. Tampilan siap perangkatnya berpasangan itu dengan ID permintaan dukungan dan berakhir dengan penanganan klien yang dapat 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	Arti yang khas	Action
400	URL tidak valid, isi atau format tidak tersedia.	Perbaiki permintaan. Selesaikan lagi untuk format.
401	Kunci hilang, tidak valid, kedaluwarsa, atau cakupan salah.	Periksa kredensial sisi server.
403	Kebijakan penyewa atau sumber menolak permintaan.	Jangan melewati kebijakan. Hubungi dukungan.
404	Pekerjaan yang tidak diketahui atau kadaluarsa.	Buat pekerjaan baru jika sesuai.
429	Batas permintaan atau pekerjaan aktif telah tercapai.	Kehormatan `retry_after_seconds`.
503	Antrian/kapasitas atau hulu sementara tidak tersedia.	Coba lagi dengan penundaan eksponensial dan jitter.

Kontrak operasional

QuickT memilih batas mobile-klien selama persetujuan sehingga jaringan kreator dan API tetap responsif.

Gunakan logika aplikasi idempotent dan jangan pernah memulai pekerjaan duplikat untuk klik pengguna yang sama.
Cache menyelesaikan metadata secara singkat, tetapi selalu memperlakukan URL unduhan yang ditandatangani sebagai berakhir.
Gunakan bounded exponential backoff dengan jitter untuk 429, 503 dan kesalahan yang dapat dicoba kembali.
Proses hanya media publik atau media yang Anda diizinkan untuk mengakses. DRM dan kontrol akses tidak dihindari.
Simpan ID permintaan dan ID pekerjaan dalam log operasional pribadi. Jangan log URL yang diajukan tanpa perlu.

Untuk akses Schema, QuickT memeriksa aktivasi sebelum eksplorasi sebelum otentikasi yang ditugaskan. Tampilan siap perangkat ini juga membuat bentuk permintaan yang didokumentasikan jelas.

AKSESS YANG DIPERIKSA OPERATO

Aktifkan melalui dukungan

Jelaskan pengalaman seluler, perkiraan lalu lintasnya, dan jaringan pembuat yang dibutuhkan. QuickT menggunakan informasi itu untuk menetapkan analisis dan izin antrean sebelum mengungkap rahasia sekali.

Minta aktivasi Kunci adalah tenant-scoped, dapat dicabut dan dikeluarkan melalui formulir Kontak. Skrip anonim tidak dapat menjalankan pekerjaan pengunduh.