Kun forhåndsvisning – aktivering kreves

Bygg nedlastinger med QuickT

QuickT dokumenterer hvordan en mobilklient vil kommunisere med tjenesten. Den kan ikke sende inn produksjonsarbeid før støtte godkjenner utformingen og aktiverer tilgang med omfang.

QuicktRouteJSON over HTTPSAsynkrone jobberBrukerinformasjon med omfang

Rask start

For API-vert kontrollerer QuickT støtteaktivert legitimasjon før et tilordnet leietakerendpunkt. Denne enhetsklare visningen gjør også en server-bare-anropsbane klar.

Leietaker-URLhttps://quickt.io

AutentiseringX-API-Key: pending_activation_…

KlientprofilQuicktRoute

API-versjonv1

# 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 Credential sikkerhet rundt server-side hemmelig lagring. Dens enhet-klar visning sammenligner ingen klient buntet innbygging. Ingen offentlige logger eller repositories forblir den endelige sjekken.

Løse en kobling

For Resolve-operasjon kontrollerer QuickT kildeoppdagelse før formater fra en innsendt URL. Denne enhetsklare visningen gjør også ingen oppfunnet utganger klare.

POST/v1/resolveOmfang: løse

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

QuickT organiserer Format-identifikator rundt den returnerte verdien uendret. Dens enhetsklare visning sammenligner per-link tilgjengelighet. Ingen gjettet kvalitetsetikett forblir den endelige sjekken.

Opprett og følg en nedlastingsjobb

For å forklare Jobb opprettelse, QuickT skiller asynkron forberedelse fra en kort HTTP forespørsel. En enhet-klar visning gir begrenset arbeidstaker utførelse sin egen plass.

POST/v1/jobsOmfang: jobber

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

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

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

En innledende ventetid på ett sekund er utgangspunktet for jobbavstemning på QuickT. En enhetsklar visning presenterer deretter begrenset tilbakeslag og forklarer midlertidig signert levering.

Forutsigbare feil

For Feil-kontrakt begynner QuickT med én ikke-2xx-konvolutt, den enhetsklare visningen parer den med en ID for støtteforespørsel og avslutter med forutsigbar 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 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

QuickT velger mobilklientgrenser under godkjenning, slik at skapernettverk og API forblir responsive.

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.

For Schema-tilgang kontrollerer QuickT aktivering før utforskning før tildelt autentisering. Denne enhetsklare visningen gjør også dokumenterte forespørselsformer klare.

TILGANG SOM OVERVÅKES AV OPERATOR

Aktiver gjennom støtte

Beskriv mobilopplevelsen, forventet trafikk og skapernettverkene den trenger. QuickT bruker denne informasjonen til å tildele analyse- og køtillatelser før hemmeligheten avsløres.

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