Pouze náhled — vyžaduje aktivaci

Sestavte stahování s QuickDL

QuickDL Podpora musí ověřit produkt, než bude možné použít privátní klíč a kvótu, a to včetně ověření, zda je produkt kompatibilní s požadovaným produktem.

QuickDlJobsJSON přes HTTPSAsynchronní úlohyPověření s rozsahem

Rychlý start

Pro přístup k API v QuickDL nejprve potřebujete přihlašovací údaje aktivované podporou. Poté použijte koncový bod přidělený vašemu tenantovi. Volání musí probíhat pouze ze serveru.

URL klientahttps://quickdl.app

AutentizaceX-API-Key: pending_activation_…

Profil klientaQuickDlJobs

Verze 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 zpracovává zabezpečení pověření tak, že nejprve identifikuje tajné úložiště na straně serveru, poté neprovede vkládání klientských svazků a neuchovává žádné veřejné protokoly ani úložiště.

Vyřešit odkaz

V QuickDL je detekce zdroje na prvním místě při vysvětlování operace Resolve. Tato kompaktní utilita následuje s formáty z jedné odeslané adresy URL a uzavírá se na žádné vynalezené výstupy.

POST/v1/resolveRozsah: vyřešit

Pole	Typ	Povinné	Popis
`public_link`	HTTPS	Ano	Veřejná nebo autorizovaná mediální stránka k analýze.
`tenant`	řetězec	Ne.	Přiřazená doména klienta. Obvykle se vynechává.

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

QuickDL zpracovává identifikátor formátu tak, že nejprve identifikuje vrácenou hodnotu beze změny, následuje dostupnost na odkaz a nedrží v pohledu žádný odhadovaný štítek kvality.

Vytvoření a sledování úlohy stahování

QuickDL kompaktní utilita kontroluje asynchronní přípravu pro vytvoření úlohy, zobrazuje krátký HTTP požadavek a nezakrývá provádění bounded worker.

POST/v1/jobsRozsah: pracovní místa

Pole	Typ	Povinné	Popis
`public_link`	HTTPS	Ano	Stejný normalizovaný zdroj předložený k vyřešení.
`download_option`	řetězec	Ano	Přesné ID z odpovědi na překlad.
`tenant`	řetězec	Ne.	Přiřazená doména klienta. Obvykle se vynechává.

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 PřijatoSave quick_job.

2Stav hlasováníGET /v1/jobs/{quick_job} se stejným klíčem.

3PřipravenOtevřete podepsanou adresu URL ke stažení.

Stav	Význam	Akce klienta
`queued`	Připuštěn do ohraničené fronty.	Anketa znovu s backoff.
`extracting`	Obnovování zdrojových metadat nebo trasy.	Pokračujte v hlasování.
`processing`	Stahování, remixování nebo slučování.	Zobrazit průběh serveru.
`ready`	Podepsané stažení je k dispozici.	Odešlete uživateli adresu URL.
`failed`	Chyba struktury terminálu.	Přečtěte si `error_code`Zkuste to znovu pouze v případě, že je to doporučeno.
`expired`	Dočasný výstup byl odstraněn.	Vytvořte novou úlohu.

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

QuickDL uvádí tři praktické zásady pro opakované zjišťování stavu úlohy: nejprve počkejte jednu sekundu, poté prodlužujte intervaly kontrol pouze do stanoveného maxima. Výsledek se doručuje prostřednictvím dočasného podepsaného odkazu.

Předvídatelné chyby

QuickDL přistupuje k chybové smlouvě prostřednictvím jedné obálky, která není 2xx, a poté ID požadavku na podporu.

{
  "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": "…"
}

Hypertext Transfer Protocol	Typický význam	Akce
400	Neplatná adresa URL, tělo nebo nedostupný formát.	Opravte požadavek. Znovu vyřešte formáty.
401	Chybějící, neplatný, vypršený nebo nesprávný rozsah klíče.	Zkontrolujte pověření na straně serveru.
403	Klient nebo zdrojové zásady požadavek zamítly.	Nepřekračujte pravidla. Kontaktujte podporu.
404	Neznámá nebo vypršela pracovní pozice.	V případě potřeby vytvořte novou úlohu.
429	Dosáhli jste limitu požadavků nebo aktivních úloh.	Honor `retry_after_seconds`.
503	Fronta/kapacita nebo upstream dočasně nedostupné.	Zkuste to znovu s exponenciálním zpětným odstupem a jitterem.

Provozní smlouva

QuickDL poskytuje kompaktní kvótu specifickou pro klienta, která podporuje integraci, aniž by destabilizovala zdrojové služby.

Používejte idempotentní aplikační logiku a nikdy nespouštějte duplicitní úlohy pro stejné uživatelské kliknutí.
Cache krátce vyřeší metadata, ale vždy považuje podepsané adresy URL ke stažení za vypršení platnosti.
Použijte ohraničený exponenciální backoff s jitter pro 429, 503 a opakovatelné chyby.
Zpracovávejte pouze veřejná média nebo média, ke kterým máte oprávnění. DRM a přístupová omezení nejsou obcházena.
ID požadavků a ID úloh uchovávejte v soukromých provozních protokolech. Nezapisujte do protokolů odeslané adresy URL zbytečně.

Přístup ke schématu v QuickDL nejprve vyžaduje aktivaci. Poté použijte přidělené ověřovací údaje a zdokumentovanou strukturu požadavků.

PŘÍSTUP PŘEZKOUMANÝ OPERATOREM

Aktivace prostřednictvím podpory

Sdělte QuickDL název integrace, očekávaný měsíční objem a požadované zdroje. Uveďte operace, které bude server provádět, aby schválení vedlo k vydání jednorázového klíče s úzce vymezenými oprávněními.

Požádat o aktivaci Klíče jsou omezeny na klienta, lze je odvolat a vydávají se prostřednictvím kontaktního formuláře.