Kun prøveversion — aktivering kræves

Byg downloads med QuickDL

QuickDL lader udviklere inspicere den kompakte anmodningsmodel før aktivering. Support skal validere produktet, før en privat nøgle og kvote kan bruges.

QuickDlJobsJSON over HTTPSAsynkrone jobLegitimationsoplysninger med anvendelsesområde

Hurtig start

I QuickDL kommer supportaktiverede legitimationsoplysninger først, når API-værten forklares. Det kompakte værktøj følger med en tildelt lejerendepunkt og afslutter med en serverkun kaldesti.

Lejer- URLhttps://quickdl.app

GodkendelseX-API-Key: pending_activation_…

Profil af klientQuickDlJobs

Version af 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 håndterer legitimationssikkerhed ved først at identificere server-side hemmelig opbevaring. Det følger uden indlejring af klientpakker og holder ingen offentlige logfiler eller arkiver synlige.

Løsning af et link

I QuickDL kommer kildeidentifikation først, når Resolve-operationen forklares. Det kompakte værktøj fortsætter med formater fra en indsendt URL og afslutter uden opfundne output.

POST/v1/resolveOmfang: løse

Felt	Type	Påkrævet	Beskrivelse
`public_link`	HTTPS- URL	Ja	Offentlig eller autoriseret medieside at analysere.
`tenant`	streng	Nej	Tildelt lejerdomæne. Udelades normalt.

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

QuickDL håndterer formatidentifikator ved først at identificere den returnerede værdi uændret. Det følger op med tilgængelighed pr. link og holder ingen gættet kvalitetsmærkat synligt.

Opret og følg et downloadjob

QuickDL: kompakte værktøj gennemgår asynkron forberedelse til joboprettelse. Det viser en kort HTTP-anmodning næste og skjuler ikke bundet arbejderudførelse.

POST/v1/jobsOmfang: job

Felt	Type	Påkrævet	Beskrivelse
`public_link`	HTTPS- URL	Ja	Den samme normaliserede kilde indsendt til at løse.
`download_option`	streng	Ja	Et nøjagtigt id fra forklaringssvaret.
`tenant`	streng	Nej	Tildelt lejerdomæne. Udelades normalt.

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

2AfstemningsstatusGET /v1/jobs/{quick_job} med samme nøgle.

3KlarÅbn den signerede download-URL.

Status	Betydning	Klienthandling
`queued`	Optaget i den afgrænsede kø.	Afstemning igen med tilbageslag.
`extracting`	Opdatering af kildemetadata eller rute.	Fortsæt med at stemme.
`processing`	Downloading, remuxing eller sammenlægning.	Vis server fremskridt.
`ready`	Signeret download er tilgængelig.	Send URL-adressen til brugeren.
`failed`	Terminal struktureret fejl.	Læs `error_code`. Prøv kun igen, når det anbefales.
`expired`	Midlertidig output blev fjernet.	Opret et nyt job.

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

QuickDL præsenterer tre praktiske punkter for Job-afstemning. Først kommer et indledende vent på et sekund. Det kompakte værktøj dækker derefter begrænset tilbagefald. Dets sidste punkt er midlertidig signeret levering.

Forudsigelige fejl

QuickDL nærmer sig Fejlkontakt gennem en ikke-2xx kuvert, derefter en supportanmodnings-ID. Det kompakte værktøj holder forudsigelig klienthåndtering eksplicit.

{
  "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 utilgængeligt format.	Ret anmodningen. Prøv igen for formater.
401	Manglende, ugyldig, udløbet eller forkert områdenøgle.	Kontroller legitimationsoplysningerne på serversiden.
403	Lejer- eller kildepolitikken afviste anmodningen.	Omgå ikke politikken. Kontakt support.
404	Ukendt eller udløbet job.	Opret eventuelt et nyt job.
429	Grænsen for anmodninger eller aktive job er nået.	Ære `retry_after_seconds`.
503	Kø/kapacitet eller opstrøm midlertidigt utilgængelig.	Prøv igen med eksponentiel tilbagefald og jitter.

Driftskontrakt

QuickDL tildeler en kompakt, klientspecifik kvote, der understøtter integrationen uden at destabilisere kildetjenesterne.

Brug idempotent programlogik, og start aldrig dublerede job for det samme brugerklik.
Cache løse metadata kortvarigt, men altid behandle underskrevne download URL'er som udløber.
Brug begrænset eksponentiel tilbagetrækning med jitter for 429, 503 og genforsøgbare fejl.
Behandl kun offentlige medier eller medier, du har tilladelse til at få adgang til. DRM og adgangskontroller omgås ikke.
Behold anmodnings-ID'er og job-ID'er i private driftslogfiler. Log ikke indsendte URL'er unødvendigt.

I QuickDL kommer aktivering før udforskning først, når Schema-adgang forklares. Det kompakte værktøj følger med tildelt autentificering og afsluttes på dokumenterede anmodningsformer.

OPERATØRGENNEMGÅET ADGANG

Aktivér gennem støtte

Angiv QuickDL med integrationsnavnet, forventet månedligt volumen og nødvendige kilder. Identificer de operationer, serveren vil udføre, så godkendelsen resulterer i en snævert afgrænset, engangs nøgle.

Anmod om aktivering Nøgler er lejerafgrænsede, kan tilbagekaldes og udstedes via kontaktformularen. Anonyme scripts kan ikke udføre downloaderarbejde.