Kun forhåndsvisning – aktivering kreves

Bygg nedlastinger med QuickDL

QuickDL lar utviklere inspisere den kompakte forespørselsmodellen før aktivering. Støtte må validere produktet før en privat nøkkel og kvote blir brukbar.

QuickDlJobsJSON over HTTPSAsynkrone jobberBrukerinformasjon med omfang

Rask start

I QuickDL kommer støtte-aktiverte legitimasjoner først når API-vert forklares. Det kompakte verktøyet følger med en tildelt leietakerendepunkt og avsluttes med en server-only kallsti.

Leietaker-URLhttps://quickdl.app

AutentiseringX-API-Key: pending_activation_…

KlientprofilQuickDlJobs

API-versjonv1

# 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 håndterer legitimasjonssikkerhet ved først å identifisere hemmelig lagring på serversiden. Den følger med ingen klientbunt innbygging og holder ingen offentlige logger eller repositories i sikte.

Løse en kobling

I QuickDL kommer kildedeteksjon først når du forklarer Resolve-operasjonen. Det kompakte verktøyet følger med formater fra en innsendt URL og lukker på ingen oppfunnet utganger.

POST/v1/resolveOmfang: løse

Felt	Type	Påkrevd	Beskrivelse
`public_link`	HTTPS-URL	Ja	Offentlig eller autorisert medieside å analysere.
`tenant`	streng	Nei	Tilordnet leierdomene. Vanligvis utelatt.

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

QuickDL håndterer Format-identifikator ved først å identifisere den returnerte verdien uendret. Den følger med per-link tilgjengelighet og holder ingen gjettet kvalitetsmerke i sikte.

Opprett og følg en nedlastingsjobb

QuickDL s kompakte verktøy gjennomgår asynkron forberedelse for jobboppretting. Det viser en kort HTTP-forespørsel neste og skjuler ikke begrenset arbeidsutførelse.

POST/v1/jobsOmfang: jobber

Felt	Type	Påkrevd	Beskrivelse
`public_link`	HTTPS-URL	Ja	Den samme normaliserte kilden innlevert for å løse.
`download_option`	streng	Ja	En nøyaktig ID fra løsningssvaret.
`tenant`	streng	Nei	Tilordnet leierdomene. Vanligvis utelatt.

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 AkseptertLagre@ action: button quick_job.

2AvstemningsstatusGET /v1/jobs/{quick_job} med samme nøkkel.

3KlarÅpne den signerte nedlastingsadressen.

Status	Betydning	Klienthandling
`queued`	Opptatt i den begrensede køen.	Avstemning igjen med baklengs.
`extracting`	Oppdaterer kildemetadata eller rute.	Fortsett å avstemme.
`processing`	Laster ned, remikser eller slår sammen.	Vis server fremgang.
`ready`	Signert nedlasting er tilgjengelig.	Send URL-adressen til brukeren.
`failed`	Terminalstrukturert feil.	Lest `error_code`Prøv på nytt bare når det anbefales.
`expired`	Midlertidig utgang ble fjernet.	Opprett en ny jobb.

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

QuickDL presenterer tre praktiske punkter for Job polling. Først kommer ett sekunds initial ventetid. Det kompakte verktøyet dekker deretter begrenset tilbakekobling. Det siste punktet er midlertidig signert levering.

Forutsigbare feil

QuickDL nærmer seg Feil kontrakt gjennom en ikke-2xx konvolutt, deretter en støtte forespørsel ID. Den kompakte verktøyet holder forutsigbar klient håndtering eksplisitt.

{
  "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	Typisk betydning	Handling
400	Ugyldig URL, brødtekst eller utilgjengelig format.	Rett opp forespørselen. Løs igjen for formater.
401	Manglende, ugyldig, utløpt eller feil omfang nøkkel.	Sjekk server-side legitimasjon.
403	Leietaker eller kildepolicy avslo forespørselen.	Ikke omgå policyen. Kontakt kundestøtte.
404	Ukjent eller utløpt jobb.	Opprett en ny jobb om det er passende.
429	Grensen for forespørsler eller aktive jobber er nådd.	Ære `retry_after_seconds`.
503	Kø/kapasitet eller oppstrøms midlertidig utilgjengelig.	Prøv igjen med eksponentiell tilbakeslag og jitter.

Driftskontrakt

QuickDL gir en kompakt, klientspesifikk kvote som støtter integrasjonen uten å destabilisere kildetjenestene.

Bruk idempotent programlogikk og aldri starte dupliserte jobber for samme bruker klikk.
Cache løse metadata kort, men alltid behandle signerte nedlastingsadresser som utløper.
Bruk begrenset eksponentiell tilbakeslag med jitter for 429, 503 og gjentatte feil.
Behandle bare offentlige medier eller medier du har autorisert tilgang til. DRM og tilgangskontroller omgås ikke.
Oppbevar forespørsels-ID-er og jobb-ID-er i private driftslogger. Ikke logg innsendte URL-er unødvendig.

I QuickDL kommer aktivering før utforskning først når Schema-tilgang forklares. Det kompakte verktøyet følger med tildelt autentisering og avsluttes med dokumenterte forespørselsformer.

TILGANG SOM OVERVÅKES AV OPERATOR

Aktiver gjennom støtte

Gi QuickDL integrasjonsnavnet, forventet månedlig volum og nødvendige kilder. Identifiser operasjonene serveren vil utføre slik at godkjenning gir en nøye avgrenset, engangsnøkkel.

Be om aktivering Nøklene er basert på leietakers omfang, kan tilbakekalles og utstedes via Kontaktskjemaet.