Alleen voorbeeld — activering vereist

Bouw downloads met QuickT

QuickT documenteert hoe een mobiele client met de service zou communiceren. Het kan geen productiewerk indienen totdat ondersteuning het ontwerp goedkeurt en gescopeerde toegang inschakelt.

QuicktRouteVerzenden van JSON over HTTPSAsynchrone jobsReferenties met bereik
01

Snel aan de slag

Voor API-host controleert QuickT eerst ondersteuningsgeactiveerde referenties voordat een toegewezen tenant-eindpunt wordt benaderd. Deze apparaatklare weergave maakt ook een server-only oproeppad duidelijk.

URL van tenanthttps://quickt.io
AuthenticatieX-API-Key: pending_activation_…
Profiel van de klantQuicktRoute
API-versiev1
# 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 organiseert Credential-veiligheid rond serverzijde geheime opslag. De apparaat-klaar weergave vergelijkt geen client-bundel embedding. Geen openbare logs of repositories blijven de laatste controle.

02

Een koppeling oplossen

Voor Resolve-operatie controleert QuickT brondetectie voordat formaten van één ingediende URL worden verwerkt. Deze apparaatklare weergave maakt ook duidelijk dat er geen verzonnen outputs zijn.

POST/v1/resolveToepassingsgebied: oplossen
VeldTypeVereistBeschrijving
route_sourceHTTPS-URLJa.Openbare of geautoriseerde mediapagina om te analyseren.
tenanttekenreeksNee.Toegewezen tenantdomein. Meestal weggelaten.
{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

QuickT organiseert Formaatidentificatie rond de ongewijzigde geretourneerde waarde. De apparaatklare weergave vergelijkt beschikbaarheid per link. Geen geraden kwaliteitslabel blijft de laatste controle.

03

Maak en volg een downloadtaak

Om Job creation uit te leggen, scheidt QuickT asynchrone voorbereiding van een korte HTTP-aanvraag. Een apparaatklare weergave geeft gebonden werkuitvoering een eigen plek.

POST/v1/jobsScope: vacatures
VeldTypeVereistBeschrijving
route_sourceHTTPS-URLJa.Dezelfde genormaliseerde bron ingediend om op te lossen.
route_formattekenreeksJa.Een exacte ID uit de resolve-respons.
tenanttekenreeksNee.Toegewezen tenantdomein. Meestal weggelaten.
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 GeaccepteerdOpslaan route_job.
2Poll status 1GET /v1/jobs/{route_job} met dezelfde sleutel.
3KlaarOpen de ondertekende download-URL.
StatusBetekenisActie van de klant
queuedToegestaan in de beperkte wachtrij.Poll weer met achteruit.
extractingBronmetadata of route vernieuwen.Ga door met pollen.
processingBezig met downloaden, remuxen of samenvoegen.Toon server voortgang.
readyOndertekende download is beschikbaar.Stuur de URL naar de gebruiker.
failedTerminal gestructureerde fout.Lees error_codeProbeer het alleen opnieuw als dat wordt geadviseerd.
expiredTijdelijke uitvoer werd verwijderd.Maak een nieuwe taak aan.
curl https://quickt.io/v1/jobs/ROUTE_JOB \
  -H "X-API-Key: $QUICKT_ROUTE_TOKEN"

Een initiële wachttijd van één seconde is het startpunt voor Job polling op QuickT. Een apparaat-klaar weergave toont vervolgens begrensde backoff en legt tijdelijke ondertekende levering uit.

04

Voorspelbare fouten

Voor Foutcontract begint QuickT met één niet-2xx envelop. De apparaat-klaar weergave koppelt dit aan een ondersteuningsverzoek-ID en eindigt met voorspelbare clientafhandeling.

{
  "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": "…"
}
HTTPTypische betekenisActie
400Ongeldige URL, body of niet beschikbare indeling.Corrigeer de aanvraag. Los opnieuw op voor formaten.
401Ontbrekende, ongeldige, verlopen of verkeerd bereik sleutel.Controleer de serverzijde referentie.
403Tenant of bronbeleid heeft de aanvraag afgewezen.Omzeil het beleid niet. Neem contact op met de ondersteuning.
404Onbekende of verlopen vacature.Maak indien nodig een nieuwe taak aan.
429Aanvraag- of actieve-taaklimiet bereikt.Eer retry_after_seconds.
503Wachtrij/capaciteit of upstream tijdelijk niet beschikbaar.Probeer het opnieuw met exponentiële backoff en jitter.
05

Operationeel contract

QuickT kiest mobiele clientlimieten tijdens goedkeuring zodat creatornetwerken en de API responsief blijven.

Voor Schema-toegang controleert QuickT activatie vóór verkenning en vóór toegewezen authenticatie. Deze apparaat-klaar weergave maakt ook gedocumenteerde aanvraagvormen duidelijk.

DOOR DE OPERATOR BEHEERDE TOEGANG

Activeren via ondersteuning

Beschrijf de mobiele ervaring, de verkeersverwachting en de creator-netwerken die het nodig heeft. QuickT gebruikt die informatie om analyse- en wachtrijtoestemmingen toe te wijzen voordat het geheim eenmaal wordt onthuld.

Vraag activering aan Sleutels zijn tenant-gebonden, intrekbaar en worden uitgegeven via het contactformulier. Anonieme scripts kunnen geen downloadprogramma-taken uitvoeren.