Tik peržiūra – reikia aktyvinti

Sukurkite atsisiuntimus su QuickDL

QuickDL leidžia kūrėjams iš anksto patikrinti kompaktišką užklausos modelį prieš aktyvavimą. Palaikymas turi patvirtinti produktą prieš privačiam raktui ir kvotai tapus naudojamais.

QuickDlJobsJSON per HTTPSAsinchroniniai darbaiApimties kredencialai

Greita pradžia

QuickDL atveju, paaiškinant API šeimininką, pirmiausia pateikiami palaikymu suaktyvinti kredencialai. Ši kompaktiška priemonė tęsiasi priskirtu nuomininko galiniu tašku ir baigiasi tik serverio kvietimo keliu.

Nuomotojo URLhttps://quickdl.app

Autentiškumo patvirtinimasX-API-Key: pending_activation_…

Kliento profilisQuickDlJobs

API versijav1

# 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 tvarko Kredencialų saugumą pirmiausia identifikuodamas serverio pusės slaptą saugyklą. Toliau nesudeda kliento paketo ir nesaugo viešų žurnalų ar saugyklų matymo lauke.

Nuorodos išsprendimas

QuickDL šaltinio aptikimas yra pirmas, kai paaiškinama Resolve operacija. Šis kompaktiškas įrankis seka formatus iš vieno pateikto URL ir baigiasi be išrasto išvesties.

POST/v1/resolveTaikymo sritis: išspręsti

Laukas	Tipas	Būtinas	Aprašymas
`public_link`	HTTPS URL	Taip	Viešas arba įgaliotas žiniasklaidos puslapis analizuoti.
`tenant`	eilutė	Ne	Priskirtas nuomotojo domenas. Paprastai praleidžiamas.

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

QuickDL tvarko Formato identifikatorių, pirmiausia identifikuodama grąžintą reikšmę nepakitusią. Toliau tikrina prieinamumą pagal nuorodą ir nerodo spėjamos kokybės žymos.

Atsisiuntimo užduoties kūrimas ir sekimas

QuickDL kompaktiška priemonė peržiūri asinchroninį pasirengimą darbo kūrimui. Ji rodo trumpą HTTP užklausą ir neužstoja riboto darbininko vykdymo.

POST/v1/jobsTaikymo sritis: darbo vietos

Laukas	Tipas	Būtinas	Aprašymas
`public_link`	HTTPS URL	Taip	Tas pats normalizuotas šaltinis pateiktas išspręsti.
`download_option`	eilutė	Taip	Tikslus ID iš atsakymo į sprendimą.
`tenant`	eilutė	Ne	Priskirtas nuomotojo domenas. Paprastai praleidžiamas.

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 PriimtaIšsaugoti quick_job.

2Apklausos būsenaGET /v1/jobs/{quick_job} tuo pačiu raktu.

3ParuoštaAtidarykite pasirašytą atsisiuntimo URL.

Būsena	Reikšmė	Kliento veiksmas
`queued`	Priimtas į ribotą eilę.	Apklausa vėl su atgal.
`extracting`	Atnaujinami šaltinio metaduomenys arba maršrutas.	Tęskite apklausą.
`processing`	Parsisiuntimas, remiksas ar sujungimas.	Rodyti serverio pažangą.
`ready`	Pasirašytas atsisiuntimas yra prieinamas.	Siųsti URL vartotojui.
`failed`	Terminalo struktūrinė klaida.	Skaityti `error_code`Bandykite dar kartą tik tada, kai patartina.
`expired`	Laikinas išėjimas buvo pašalintas.	Sukurkite naują darbą.

curl https://quickdl.app/v1/jobs/QUICK_JOB \
  -H "X-API-Key: $QUICKDL_JOB_KEY"

QuickDL pateikia tris praktinius patarimus darbo apklausai. Pirmas – vienos sekundės pradinė pauzė. Kompaktiška priemonė tada apima ribotą atidėjimą. Jos paskutinis punktas – laikinas pasirašytas pristatymas.

Numatomos klaidos

QuickDL prieina prie Klaidos sutarties per vieną ne 2xx aplanką, tada per palaikymo užklausos ID. Kompaktiška priemonė aiškiai palaiko numatomą kliento valdymą.

{
  "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	Tipiška reikšmė	Veiksmas
400	Netinkamas URL, tekstas arba negalimas formatas.	Ištaisykite užklausą. Išspręskite dar kartą formatams.
401	Trūksta, negalioja, pasibaigė galiojimo laikas arba neteisingos apimties raktas.	Patikrinkite serverio pusės kredencialus.
403	Nuomininkas arba šaltinio strategija atmetė užklausą.	Neaplenkite politikos. Susisiekite su palaikymo tarnyba.
404	Nežinomas arba pasibaigęs darbas.	Jei reikia, sukurkite naują darbą.
429	Pasiektas užklausos arba aktyvių užduočių limitas.	Garbė `retry_after_seconds`.
503	Eilė / talpa arba priešsroviui laikinai neprieinama.	Bandykite dar kartą su eksponentiniu atgal ir drebėjimu.

Veiklos sutartis

QuickDL suteikia kompaktišką, klientui specifinę kvotą, kuri palaiko integraciją nedestabilizuodama šaltinio paslaugų.

Naudokite idempotentinę programos logiką ir niekada nepradėkite pasikartojančių užduočių tam pačiam vartotojo paspaudimui.
Talpykloje trumpai išsprendžiami metaduomenys, tačiau visada pasirašyti atsisiuntimo URL laikomi pasibaigusiais.
Naudokite ribotą eksponentinį atgalinį atmetimą su drebėjimu, kad 429, 503 ir pakartotinai bandomos klaidos.
Apdorokite tik viešąją laikmeną arba laikmeną, prie kurios turite prieigą. DRM ir prieigos kontrolės priemonės nebus apeitos.
Saugokite užklausų ID ir užduočių ID privačiuose veiklos žurnaluose. Nereikia registruoti pateiktų URL be reikalo.

QuickDL atveju, paaiškinant schemos prieigą, pirmiausia pateikiamas aktyvavimas prieš tyrinėjimą. Ši kompaktiška priemonė tęsiasi priskirtu autentifikavimu ir baigiasi dokumentuotomis užklausų formomis.

EKSPLOATUOTOJO PERŽIŪRIMAS

Aktyvinkite per palaikymą

Pateikite QuickDL integracijos pavadinimą, numatomą mėnesinį kiekį ir reikiamus šaltinius. Nustatykite operacijas, kurias serveris atliks, kad patvirtinimas suteiktų siaurai apibrėžtą, vienkartinį raktą.

Prašykite aktyvavimo Raktai yra nuomininko apimties, atšaukiami ir išduodami per Susisiekite formą. Anoniminiai scenarijai negali vykdyti atsisiuntimo programos darbo.