Pratinjau saja — aktivasi diperlukan

Bangun unduhan dengan QuickDL

QuickDL memungkinkan pengembang memeriksa model permintaan ringkas sebelum aktivasi. Dukungan harus memvalidasi produk sebelum kunci pribadi dan kuota dapat digunakan.

QuickDlJobsJSON melalui HTTPSTugas asinkronKredensial yang dijangkau

Awal yang cepat

Dalam QuickDL, dukungan-diaktifkan kredensial datang pertama kali ketika menjelaskan host API. Itu utilitas kompak mengikuti dengan titik akhir tenant yang ditugaskan dan menutup pada jalur panggilan server-hanya.

URL Tenanthttps://quickdl.app

OtentikasiX-API-Key: pending_activation_…

Profil klienQuickDlJobs

Versi APIv1

# 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 menangani keamanan Kredensial dengan terlebih dahulu mengidentifikasi penyimpanan rahasia sisi server. Ini diikuti tanpa penyematan bundel klien dan tidak menyimpan log publik atau repositori yang terlihat.

Menyelesaikan sebuah tautan

Dalam QuickDL, deteksi sumber datang pertama saat menjelaskan operasi Resolve. Utilitas ringkas itu kemudian mengikuti dengan format dari satu URL yang diajukan dan ditutup tanpa output yang dibuat.

POST/v1/resolveScope: menyelesaikan

Medan	Jenis	Diperlukan	Deskripsi
`public_link`	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
}

QuickDL menangani pengenal Format dengan terlebih dahulu mengidentifikasi nilai yang dikembalikan tanpa perubahan. Ini diikuti dengan ketersediaan per-tautan dan tidak menyimpan label kualitas yang ditebak dalam tampilan.

Buat dan ikuti pekerjaan unduhan

Utilitas ringkas QuickDL meninjau persiapan asinkron untuk pembuatan Pekerjaan. Ini menampilkan permintaan HTTP singkat berikutnya dan tidak menyembunyikan eksekusi pekerja terbatas.

POST/v1/jobsLingkup: pekerjaan

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

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

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

QuickDL menyajikan tiga poin praktis untuk polling Job. Pertama datang satu detik awal menunggu. Utilitas kompak kemudian menutupi capped backoff. Titik terakhirnya adalah pengiriman sementara yang ditandatangani.

Kesalahan yang dapat diprediksi

QuickDL mendekati kontrak Kesalahan melalui satu amplop non-2xx, kemudian ID permintaan dukungan. Utilitas ringkas menjaga penanganan klien yang dapat diprediksi secara eksplisit.

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

QuickDL memberikan kuota kompak khusus klien yang mendukung integrasi tanpa mengganggu layanan sumber.

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.

Dalam QuickDL, aktivasi sebelum eksplorasi datang pertama kali ketika menjelaskan akses Schema. Itu utilitas kompak mengikuti dengan otentikasi yang ditugaskan dan menutup pada bentuk permintaan yang terdokumentasi.

AKSESS YANG DIPERIKSA OPERATO

Aktifkan melalui dukungan

Berikan QuickDL dengan nama integrasi, volume bulanan yang diharapkan, dan sumber yang diperlukan. Identifikasi operasi yang akan dilakukan server sehingga persetujuan menghasilkan kunci satu kali dengan cakupan terbatas.

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