Kun prøveversion — aktivering kræves

Byg downloads med QuickT

QuickT dokumenterer, hvordan en mobilklient vil kommunikere med tjenesten. Den kan ikke sende produktionsarbejde, før support godkender designet og aktiverer adgang med omfang.

QuicktRouteJSON over HTTPSAsynkrone jobLegitimationsoplysninger med anvendelsesområde

Hurtig start

For API-vært kontrollerer QuickT supportaktiverede legitimationsoplysninger før et tildelt lejer-slutpunkt. Denne enhedsklare visning gør også en server-kun-opkaldssti klar.

Lejer- URLhttps://quickt.io

GodkendelseX-API-Key: pending_activation_…

Profil af klientQuicktRoute

Version af APIv1

# Available only after support activation
export QUICKT_ROUTE_TOKEN="issued-after-review"

curl -X POST https://quickt.io/v1/resolve \
  -H "X-API-Key: $QUICKT_ROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"route_source":"https://www.youtube.com/watch?v=VIDEO_ID"}'

QuickT organiserer legitimationssikkerhed omkring server-side hemmelig lagring. Dens enhedsvisning sammenligner ingen klientpakkeindlejring. Ingen offentlige logfiler eller arkiver forbliver den endelige kontrol.

Løsning af et link

For Resolve-operation kontrollerer QuickT kildedetektering før formater fra en indsendt URL. Denne enhedsklare visning gør også ingen opfundne udgange klare.

POST/v1/resolveOmfang: løse

Felt	Type	Påkrævet	Beskrivelse
`route_source`	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
}

QuickT organiserer formatidentifikator omkring den returnerede værdi uændret. Dens enhedsklare visning sammenligner tilgængelighed pr. link. Ingen gættet kvalitetsmærkat forbliver den endelige kontrol.

Opret og følg et downloadjob

For at forklare Job skabelse, QuickT adskiller asynkron forberedelse fra en kort HTTP-anmodning. En enhed-klar visning giver bounded worker udførelse sit eget sted.

POST/v1/jobsOmfang: job

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

curl -X POST https://quickt.io/v1/jobs \
  -H "X-API-Key: $QUICKT_ROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"route_source":"https://www.youtube.com/watch?v=VIDEO_ID","route_format":"18"}'

1202 AccepteretGem route_job.

2AfstemningsstatusGET /v1/jobs/{route_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://quickt.io/v1/jobs/ROUTE_JOB \
  -H "X-API-Key: $QUICKT_ROUTE_TOKEN"

En indledende ventetid på ét sekund er udgangspunktet for jobafstemning på QuickT. En enhedsklar visning præsenterer derefter begrænset tilbageholdelse og forklarer midlertidig underskrevet levering.

Forudsigelige fejl

For Error-kontrakten starter QuickT med en ikke-2xx-konvolut, som den enhedsklare visning parrer med et supportanmodnings-id, og som afsluttes med forudsigelig klienthåndtering.

{
  "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

QuickT vælger grænser for mobilklienter under godkendelse, så skabernetværk og API'en forbliver lydhøre.

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.

For Schema-adgang kontrollerer QuickT aktivering før udforskning før tildelt godkendelse. Denne enhedsklare visning gør også dokumenterede anmodningsformer klare.

OPERATØRGENNEMGÅET ADGANG

Aktivér gennem støtte

Beskriv mobiloplevelsen, dens trafikforventning og de skabernetværk, den har brug for. QuickT bruger disse oplysninger til at tildele analyse- og køtilladelser, før hemmeligheden afsløres én gang.

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