Ngan ukur preview — aktivasina diperyogikeun

Ngawangun unduhan sareng QuickDL

QuickDL ngamungkinkeun pamekar pikeun mariksa modél pamundut kompak sateuacan aktivasina. Dukungan kedah mastikeun produk sateuacan konci pribadi sareng kuota tiasa dianggo.

QuickDlJobsJSON ngalangkungan HTTPSPakaryan asinkronKredensial anu diwatesan

Mimitian gancang

Dina QuickDL, kredensial anu diaktipkeun ku dukungan datang heula nalika ngajelaskeun host API. Utilitas kompak éta nuturkeun ku titik akhir tenant anu ditugaskeun sareng ditutup dina jalur telepon server-wungkul.

URL panyewahttps://quickdl.app

AuténtikasiX-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 ngatur kaamanan Kredensial ku mimiti ngaidentipikasi panyimpenan rahasia sisi server. Teras henteu ngalebetkeun bundel klien sareng henteu nyimpen log publik atanapi repositori anu katingali.

Ngarengsekeun hiji link

Dina QuickDL, deteksi sumber dimimitian heula nalika ngajelaskeun operasi Resolve. Utilitas kompak éta nuturkeun format tina hiji URL anu dikirimkeun sareng ditutup tanpa hasil anu diada-adakeun.

POST/v1/resolveLingkup: ngarengsekeun

Medan	Tipe	Diperyogikeun	Katerangan
`public_link`	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
}

QuickDL ngatur idéntifikasi Format ku mimiti ngaidentipikasi nilai anu dipulangkeun tanpa robah. Teras nuturkeun kalancaran per-link sareng henteu nahan labél kualitas anu diperkirakeun dina pandangan.

Nyiptakeun sareng nuturkeun padamelan unduhan

Utilitas kompak QuickDL marios persiapan asinkron pikeun nyiptakeun Job. Ieu nunjukkeun pamundut HTTP pondok salajengna sareng henteu nyumputkeun palaksanaan pagawé anu diwatesan.

POST/v1/jobsLingkup: padamelan

Medan	Tipe	Diperyogikeun	Katerangan
`public_link`	URL HTTPS	Leres	Sumber normalisasi anu sami diserahkeun pikeun direngsekeun.
`download_option`	string	Leres	ID anu pasti tina réspon ngarengsekeun.
`tenant`	string	Henteu	Ditugaskeun domain panyewa. Biasana dileungitkeun.

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

2Status pollingGET /v1/jobs/{quick_job} kalayan konci anu sami.

3SiapBuka URL unduhan anu ditandatanganan.

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

QuickDL nampilkeun tilu titik praktis pikeun polling Job. Anu kahiji nyaéta antosan awal salila hiji detik. Utilitas kompak teras nutupan backoff anu diwatesan. Titik ahirna nyaéta pangiriman ditandatanganan samentawis.

Kasalahan anu tiasa diprediksi

QuickDL ngadeukeutan kontrak Kasalahan ngaliwatan hiji amplop non-2xx, teras ID pamundut dukungan. Utilitas kompak ngajaga pangaturan klien anu tiasa diprediksi sacara 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	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

QuickDL masihan kuota kompak, khusus klien anu ngadukung integrasi tanpa ngaganggu jasa sumber.

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, 503 sareng 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.

Dina QuickDL, aktivasina sateuacan eksplorasi datang heula nalika ngajelaskeun aksés Skéma. Utilitas kompak éta nuturkeun ku oténtikasi anu ditugaskeun sareng ditutup dina bentuk pamundut anu didokumentasikeun.

AKSES DIPANGKEUN OPERATOR

Aktipkeun ngalangkungan dukungan

Pasihan QuickDL nami integrasi, volume bulanan anu dipiharep, sareng sumber anu diperyogikeun. Identipikasi operasi anu bakal dilakukeun ku server supados persetujuan ngahasilkeun konci hiji-waktos anu wengkuanana sempit.

Kéngingkeun aktivasina Konci téh diwatesan ku panyewa, bisa dibatalkeun jeung dikaluarkeun ngaliwatan formulir Kontak. Skrip anonim teu bisa ngalaksanakeun pagawéan pangunduh.