Pralihat sahaja — pengaktifan diperlukan

Muat turun binaan dengan QuickDL

QuickDL membiarkan pemaju memeriksa model permintaan padat sebelum pengaktifan. Sokongan mesti mengesahkan produk sebelum kunci peribadi dan kuota menjadi boleh digunakan.

QuickDlJobsJSON melalui HTTPSTugas asinkronPengenalan yang diskopkan

Mulakan dengan cepat

Dalam QuickDL, kelayakan yang diaktifkan sokongan datang terlebih dahulu apabila menerangkan hos API. Utiliti padat itu mengikuti dengan titik akhir penyewa yang ditugaskan dan ditutup pada laluan panggilan pelayan sahaja.

URL Penyewahttps://quickdl.app

PengesahanX-API-Key: pending_activation_…

Profil PelangganQuickDlJobs

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 mengendalikan keselamatan Credential dengan pertama mengenal pasti penyimpanan rahsia sisi pelayan. Ia mengikuti dengan tiada penempatan bundle pelanggan dan menyimpan tiada log awam atau repositori dalam pandangan.

Menyelesaikan pautan

Dalam QuickDL, pengesanan sumber datang terlebih dahulu apabila menerangkan operasi Resolve. Utiliti padat itu mengikuti dengan format dari satu URL yang dikemukakan dan ditutup pada tiada output yang dicipta.

POST/v1/resolveSkop: menyelesaikan

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

QuickDL mengendalikan pengecam Format dengan terlebih dahulu mengenal pasti nilai yang dikembalikan tanpa perubahan. Ia diikuti dengan ketersediaan setiap pautan dan tidak menyimpan label kualiti yang dianggarkan dalam pandangan.

Cipta dan ikuti kerja muat turun

Utiliti padat QuickDL mengkaji persiapan tak segerak untuk penciptaan Pekerjaan. Ia menunjukkan permintaan HTTP pendek seterusnya dan tidak mengaburkan pelaksanaan pekerja terikat.

POST/v1/jobsSkop: pekerjaan

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

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

QuickDL membentangkan tiga perkara praktikal untuk pengundian Kerja. Pertama adalah menunggu awal selama satu saat. Utiliti padat kemudian meliputi had backoff. Perkara terakhirnya adalah penghantaran bertandatangan sementara.

Kesalahan yang boleh diramalkan

QuickDL mendekati kontrak Ralat melalui satu sampul bukan-2xx, kemudian ID permintaan sokongan. Utiliti padat mengekalkan pengendalian klien yang boleh diramal 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	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

QuickDL memberikan kuota padat, khusus pelanggan yang menyokong integrasi tanpa menstabilkan perkhidmatan sumber.

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.

Dalam QuickDL, pengaktifan sebelum penerokaan datang terlebih dahulu apabila menerangkan akses Skim. Utiliti padat itu mengikuti dengan pengesahan yang ditugaskan dan ditutup pada bentuk permintaan yang didokumentasikan.

AKSESS YANG DIPERIKSA OPERASI

Aktifkan melalui sokongan

Sediakan QuickDL dengan nama integrasi, jangkaan jumlah bulanan dan sumber yang diperlukan. Kenal pasti operasi yang akan dilakukan oleh pelayan supaya kelulusan menghasilkan kunci sekali guna yang berfokus sempit.

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