Len ukážka – vyžaduje sa aktivácia

Vytvárajte stiahnutia pomocou QuickDL

QuickDL umožňuje vývojárom prezrieť stručný model požiadaviek pred aktiváciou. Podpora musí produkt overiť skôr, než sa súkromný kľúč a kvóta stanú použiteľnými.

QuickDlJobsJSON cez HTTPSAsynchrónne úlohyPoverenia s rozsahom

Rýchly štart

QuickDL pri hostiteľovi API začína prihlasovacími údajmi aktivovanými podporou. Nasleduje pridelený koncový bod nájomníka a volania vykonávané výhradne zo servera.

URL nájomcuhttps://quickdl.app

AutentifikáciaX-API-Key: pending_activation_…

Profil klientaQuickDlJobs

Verzia 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 pri ochrane prihlasovacích údajov zdôrazňuje uchovávanie tajných údajov na serveri. Nesmú byť vložené do klientskeho balíka ani zverejnené v protokoloch alebo repozitároch.

Vyriešiť odkaz

QuickDL pri operácii rozpoznania najprv určí zdroj a z jednej zadanej adresy URL získa formáty. Žiadne výstupy si nevymýšľa.

POŠTA/v1/resolveRozsah: vyriešiť

Pole	Typ	Povinné	Popis
`public_link`	HTTPS URL	Áno	Verejná alebo oprávnená mediálna stránka na analýzu.
`tenant`	reťazec	Nie	Priradená doména nájomníka. Zvyčajne sa vynecháva.

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

QuickDL pri identifikátore formátu zachováva získanú hodnotu bez zmeny. Dostupnosť závisí od konkrétneho odkazu a označenie kvality sa neodhaduje.

Vytvorte a sledujte úlohu sťahovania

QuickDL pri vytváraní úlohy používa asynchrónnu prípravu, krátku požiadavku HTTP a ohraničené vykonávanie pracovným procesom.

POŠTA/v1/jobsRozsah: pracovné ponuky

Pole	Typ	Povinné	Popis
`public_link`	HTTPS URL	Áno	Rovnaký normalizovaný zdroj predložený na vyriešenie.
`download_option`	reťazec	Áno	Presné ID z odpovede na vyriešenie.
`tenant`	reťazec	Nie	Priradená doména nájomníka. Zvyčajne sa vynecháva.

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 prijatéUložiť quick_job.

2Stav anketyGET /v1/jobs/{quick_job} s rovnakým kľúčom.

3PripravenýOtvorte podpísanú URL adresu na stiahnutie.

Stav	Význam	Akcia klienta
`queued`	Prijatý do ohraničeného frontu.	Anketa znova s odstupom.
`extracting`	Obnovovanie zdrojových metadát alebo trasy.	Pokračujte v hlasovaní.
`processing`	Sťahovanie, remuxovanie alebo spájanie.	Zobrazenie priebehu servera.
`ready`	Podpísané stiahnutie je k dispozícii.	Odoslanie URL adresy používateľovi.
`failed`	Terminál štruktúrovaná chyba.	Čítať `error_code`Opakujte pokus iba v prípade, že vám to odporučia.
`expired`	Dočasný výstup bol odstránený.	Vytvorte novú úlohu.

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

QuickDL uvádza tri praktické body zisťovania stavu úlohy: počiatočné čakanie jednu sekundu, postupné predlžovanie intervalu s hornou hranicou a dočasné podpísané doručenie.

Predvídateľné chyby

QuickDL pri zmluve chybových odpovedí uvádza jednotný obal odpovede mimo rozsahu 2xx, identifikátor požiadavky pre podporu a predvídateľné spracovanie na strane klienta.

{
  "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	Typický význam	Akcia
400	Neplatná adresa URL, telo alebo nedostupný formát.	Opravte požiadavku. Vyriešte znova pre formáty.
401	Chýbajúci, neplatný, neplatný alebo nesprávny rozsah kľúča.	Skontrolujte poverenie na strane servera.
403	Nájomca alebo zdrojová politika odmietli žiadosť.	Neobchádzajte pravidlá. Obráťte sa na podporu.
404	Neznáma alebo vypršaná pracovná ponuka.	V prípade potreby vytvorte novú úlohu.
429	Dosiahnutý limit požiadaviek alebo aktívnych úloh.	Česť `retry_after_seconds`.
503	Fronta/kapacita alebo upstream dočasne nedostupné.	Skúste to znova s exponenciálnym spätným odrazom a jitterom.

Prevádzková zmluva

QuickDL udeľuje kompaktnú kvótu špecifickú pre klienta, ktorá podporuje integráciu bez destabilizácie zdrojových služieb.

Používajte idempotentnú aplikačnú logiku a nikdy nespúšťajte duplicitné úlohy pre to isté kliknutie používateľa.
Vyrovnávacia pamäť vyriešiť metadáta krátko, ale vždy zaobchádzať podpísané stiahnuť URL ako vypršať.
Použite ohraničený exponenciálny spätný chod s jitterom pre 429, 503 a opakovatelné chyby.
Spracovávajte iba verejné médiá alebo médiá, ku ktorým máte oprávnený prístup. DRM a kontroly prístupu nie sú obídené.
Uchovávajte ID žiadostí a ID úloh v súkromných prevádzkových denníkoch. Nezapisujte odoslané adresy URL zbytočne.

QuickDL vyžaduje aktiváciu pred preskúmaním schémy, pridelené overenie totožnosti a používanie zdokumentovaných tvarov požiadaviek.

PRÍSTUP KONTROLOVANÝ OPERAČOM

Aktivácia prostredníctvom podpory

Poskytnite službe QuickDL názov integrácie, očakávaný mesačný objem a požadované zdroje. Uveďte operácie vykonávané serverom, aby sa pri schválení vytvoril jednorazový kľúč s úzko vymedzenými oprávneniami.

Požiadať o aktiváciu Kľúče sú viazané na nájomníka, možno ich odvolať a vydávajú sa prostredníctvom kontaktného formulára. Anonymné skripty nemôžu vykonávať prácu sťahovača.