Samo predogled – zahteva se aktivacija

Prenosi gradnje z QuickDL

QuickDL razvijalcem omogoča pregled kompaktnega modela zahtev pred aktivacijo. Podpora mora potrditi izdelek, preden postaneta zasebni ključ in kvota uporabna.

QuickDlJobsJSON prek HTTPSAsinhroni opravkiVerifikacijske podatke z obsegom

Hitri začetek

V QuickDL so najprej podprti poverilnice, ko se pojasnjuje gostitelj API-ja. To kompaktno orodje sledi z dodeljeno končno točko najemnika in se zaključi z izključnim klicem strežnika.

URL najemnikahttps://quickdl.app

AvtentikacijaX-API-Key: pending_activation_…

Profil odjemalcaQuickDlJobs

Različica API-jav1

# 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 upravlja z varnostjo poverilnic tako, da najprej identificira shranjevanje skrivnosti na strežniški strani. Nato ne vključuje nobenega odjemalskega paketa in ne hrani javnih dnevnikov ali repozitorijev na vidiku.

Reši povezavo

V QuickDL je zaznavanje vira prvo pri razlagi delovanja Resolve. Ta kompaktno orodje sledi z formati iz enega oddanega URL-ja in se zaključi brez izmišljenih izhodov.

POST/v1/resolveObseg: razreši

Polje	Vrsta	Zahtevano	Opis
`public_link`	HTTPS URL	Da.	Javna ali pooblaščena medijska stran za analizo.
`tenant`	niz	Ne.	Dodeljena domena najemnika. Običajno izpuščeno.

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

QuickDL obravnava identifikator formata tako, da najprej prepozna vrnjeno vrednost nespremenjeno. Sledi preverjanje razpoložljivosti za vsako povezavo in ne prikazuje domnevne oznake kakovosti.

Ustvarjanje in spremljanje opravila prenosa

Kompaktno orodje QuickDL pregleda asinhrono pripravo za ustvarjanje naloge. Nato prikaže kratko HTTP zahtevo in ne zakriva izvajanja omejenega delavca.

POST/v1/jobsObseg: delovna mesta

Polje	Vrsta	Zahtevano	Opis
`public_link`	HTTPS URL	Da.	Isti normalizirani vir je bil poslan za rešitev.
`download_option`	niz	Da.	Natančna ID iz odziva reševanja.
`tenant`	niz	Ne.	Dodeljena domena najemnika. Običajno izpuščeno.

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

2Stanje anketeGET /v1/jobs/{quick_job} z istim ključem.

3PripravljenOdprite podpisan URL za prenos.

Stanje	Pomen	Dejanje stranke
`queued`	Sprejeto v omejeno čakalno vrsto.	Anketa znova z backoff.
`extracting`	Osveževanje metapodatkov vira ali poti.	Nadaljujte z glasovanjem.
`processing`	Prenos, remuxing ali združevanje.	Prikaz napredka strežnika.
`ready`	Podpisan prenos je na voljo.	Pošljite URL uporabniku.
`failed`	Napaka strukture terminala.	Preberi `error_code`Ponovite le, ko vam svetujemo.
`expired`	Začasni izhod je bil odstranjen.	Ustvarite novo delovno mesto.

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

QuickDL predstavlja tri praktične točke za anketiranje delovnih mest. Prva je ena sekunda začetnega čakanja. Nato kompaktno orodje pokriva omejeno povratno zanko. Njegova zadnja točka je začasna podpisana dostava.

Predvidljive napake

QuickDL dostopa do pogodbe o napaki prek enega ovojnika, ki ni 2xx, nato prek ID zahteve za podporo. Kompaktno orodje ohranja predvidljivo ravnanje s stranko eksplicitno.

{
  "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čen pomen	Ukrepanje
400	Neveljaven URL, telo ali nedosegljiv format.	Popravite zahtevo. Ponovno rešite za formate.
401	Manjkajoč, neveljaven, potekel ali napačnega obsega ključ.	Preverite poverilnice na strani strežnika.
403	Najemnik ali izvorna politika sta zavrnila zahtevo.	Ne zaobidite politike. Kontaktirajte podporo.
404	Neznano ali poteklo delovno mesto.	Po potrebi ustvarite novo delovno mesto.
429	Dosežena omejitev zahtev ali aktivnih opravil.	Čast. `retry_after_seconds`.
503	Čakalna vrsta/zmogljivost ali zgornji tok začasno ni na voljo.	Poskusite znova z eksponentnim zamikom in naključnim odmikom.

Pogodba o obratovanju

QuickDL podeli kompaktno, odjemalcu specifično kvoto, ki podpira integracijo brez destabilizacije izvornih storitev.

Uporabite idempotentno logiko aplikacije in nikoli ne zaženite podvojenih opravil za isti klik uporabnika.
Predpomnite metapodatke reševanja na kratko, vendar vedno obravnavajte podpisane URL-je za prenos kot potekle.
Uporabite omejen eksponentni povratek z motnjo za 429, 503 in ponovljive napake.
Obdelujte samo javne medije ali medije, do katerih imate dovoljen dostop. DRM in nadzori dostopa niso zaobšli.
Shranjujte ID-je zahtev in ID-je opravil v zasebnih operativnih dnevnikih. Ne beležite nepotrebno poslanih URL-jev.

V QuickDL je aktivacija pred raziskovanjem prva, ko razlagamo dostop do Sheme. Ta kompaktno orodje sledi dodeljeni avtentikaciji in se zaključi na dokumentiranih oblikah zahtevkov.

DOSTOP, KI GA PREGLEDUJE OPERATER

Aktivirajte prek podpore

Zagotovite QuickDL ime integracije, pričakovani mesečni obseg in zahtevane vire. Določite operacije, ki jih bo strežnik izvajal, da bo odobritev ustvarila ozko usmerjen, enkratni ključ.

Zahtevajte aktivacijo Ključi so omejeni na najemnika, preklicljivi in izdani prek kontaktnega obrazca. Anonimni skripti ne morejo izvajati nalog prenašalnika.