Samo pregled – potrebna je aktivacija

Izgradite preuzimanja s QuickDL

QuickDL omogućuje programerima da pregledaju kompaktni model zahtjeva prije aktivacije. Podrška mora potvrditi proizvod prije nego što privatni ključ i kvota postanu upotrebljivi.

QuickDlJobsJSON preko HTTPS-aAsinkroni posloviVjerodajnice s opsegom

Brzi početak rada

U QuickDL, vjerodajnice aktivirane podrškom dolaze na prvo mjesto kada se objašnjava API domaćin. Taj kompaktni uslužni program slijedi s dodijeljenom krajnjom točkom najmoprimca i zatvara se na putu poziva samo poslužitelja.

URL klijentahttps://quickdl.app

AutentifikacijaX-API-Key: pending_activation_…

Profil klijentaQuickDlJobs

Verzija 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 obrađuje sigurnost vjerodajnica tako što prvo identificira tajno pohranjivanje na strani poslužitelja. Slijedi bez ugradnje klijentskog paketa i ne drži javne zapisnike ili repozitorije u vidu.

Rješavanje veze

U QuickDL, izvor otkrivanje dolazi na prvo mjesto kada objašnjava Resolve operaciju. Taj kompaktni uslužni program slijedi s formatima iz jednog predanog URL-a i zatvara se na bez izmišljenih izlaza.

POST/v1/resolveOpseg: riješiti

Polje	Tip	Obvezno	Opis
`public_link`	HTTPS URL	Da	Javna ili ovlaštena medijska stranica za analizu.
`tenant`	string	-Ne. -Ne?	Dodijeljena domena klijenta. Obično se izostavlja.

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

QuickDL obrađuje Format identifikator tako što prvo identificira vraćenu vrijednost nepromijenjenu. Slijedi s dostupnošću po vezi i ne drži u vidu nikakvu nagađanu oznaku kvalitete.

Stvaranje i praćenje zadatka preuzimanja

QuickDL-ov kompaktni uslužni program pregledava asinkronu pripremu za stvaranje posla. Prikazuje kratki HTTP zahtjev sljedeći i ne zasjeni izvršenje ograničenog radnika.

POST/v1/jobsPodručje primjene: poslovi

Polje	Tip	Obvezno	Opis
`public_link`	HTTPS URL	Da	Isti normalizirani izvor predan za rješavanje.
`download_option`	string	Da	Točan ID iz odgovora na rješavanje.
`tenant`	string	-Ne. -Ne?	Dodijeljena domena klijenta. Obično se izostavlja.

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 PrihvaćenoSpremi quick_job.

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

3SpremniOtvorite potpisani URL za preuzimanje.

Status	Značenje	Akcija klijenta
`queued`	Prihvaćeno u ograničeni red.	Ponovno anketiranje s odmakom.
`extracting`	Osvježavanje izvornih metapodataka ili rute.	Nastavite s glasovanjem.
`processing`	Preuzimanje, remiksanje ili spajanje.	Prikaz napretka poslužitelja.
`ready`	Potpisano preuzimanje je dostupno.	Pošaljite URL korisniku.
`failed`	Terminal strukturirana pogreška.	Pročitajte `error_code`. Ponovite samo kada se savjetuje.
`expired`	Privremeni izlaz je uklonjen.	Stvorite novi posao.

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

QuickDL predstavlja tri praktične točke za Job polling. Prvo dolazi jedno sekundno početno čekanje. Kompaktni uslužni program zatim pokriva ograničeni backoff. Njegova posljednja točka je privremena potpisana isporuka.

Predvidljive pogreške

QuickDL pristupa Ugovor o pogrešci kroz jednu omotnicu koja nije 2xx, a zatim ID zahtjeva za podršku. Kompaktni uslužni program čuva predvidljivo rukovanje klijentom 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čno značenje	Akcija
400	Nevažeći URL, tijelo ili nedostupan format.	Ispravite zahtjev. Resolvirajte ponovno za formate.
401	Ključ nedostaje, nije valjan, istekao je ili ima pogrešan opseg.	Provjerite vjerodajnice na strani poslužitelja.
403	Zahtjev je odbio stanar ili izvorno pravilo.	Nemojte zaobići pravilnik. Kontaktirajte podršku.
404	Nepoznat ili istekao posao.	Stvorite novi posao ako je to prikladno.
429	Dostignuto je ograničenje zahtjeva ili aktivnih zadataka.	Čast `retry_after_seconds`.
503	Red čekanja/kapaciteta ili upstream privremeno nedostupan.	Pokušajte ponovno s eksponencijalnim backoff i jitter.

Ugovor o radu

QuickDL dodjeljuje kompaktni, klijentu specifični kvotu koja podržava integraciju bez destabilizacije izvorišnih usluga.

Koristite idempotentnu logiku aplikacije i nikada ne pokrenite duplicirane poslove za isti klik korisnika.
Predmemorija rješava metapodatke kratko, ali uvijek tretira potpisane URL-ove za preuzimanje kao isteka.
Koristite ograničeni eksponencijalni backoff s jitterom za 429, 503 i ponovljive pogreške.
Obrađujte samo javne medije ili medije za koje imate ovlaštenje pristupa. DRM i kontrole pristupa nisu zaobiđene.
ID-ove zahtjeva i ID-ove poslova čuvajte u privatnim operativnim zapisnicima. Nemojte nepotrebno bilježiti poslane URL-ove.

U QuickDL, aktivacija prije istraživanja dolazi na prvo mjesto kada se objašnjava pristup shemi. Taj kompaktni uslužni program slijedi s dodijeljenom autentifikacijom i zatvara se na dokumentirane oblike zahtjeva.

PRISTUP KOJI PREGLEDA OPERATER

Aktivirajte se putem podrške

Navedite QuickDL s nazivom integracije, očekivanim mjesečnim opsegom i potrebnim izvorima. Prepoznajte operacije koje će poslužitelj izvršiti tako da odobrenje proizvodi usko ograničeni, jednokratni ključ.

Zatražite aktivaciju Ključevi su ograničeni na zakupca, opozivi su mogući i izdaju se putem obrasca za kontakt. Anonimni skripti ne mogu izvršavati preuzimanje radova.