Endast förhandsgranskning — aktivering krävs

Bygg nedladdningar med QuickT

QuickT dokumenterar hur en mobil klient skulle kommunicera med tjänsten. Den kan inte skicka produktionsarbete förrän supporten godkänner designen och aktiverar omfattningsbaserad åtkomst.

QuicktRouteJSON över HTTPSAsynkrona jobbAutentiseringsuppgifter med omfattning

Snabbstart för Windows

För API-värd kontrollerar QuickT stödaktiverade autentiseringsuppgifter innan en tilldelad hyresgästandpunkt. Denna enhetsklara vy gör också en serverendast anropsväg tydlig.

Webbadress till klienthttps://quickt.io

AutentiseringX-API-Key: pending_activation_…

KlientprofilQuicktRoute

API-versionv1

# 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 organiserar Credential-säkerhet kring serverbaserad hemlagring. Dess enhetsklara vy jämför ingen klientpaket-inbäddning. Inga offentliga loggar eller arkiv förblir den slutgiltiga kontrollen.

Lösa en länk

För Resolve-operationen kontrollerar QuickT källupptäckt innan format från en inskickad URL. Denna enhetsklara vy gör också att inga påhittade utdata är oklara.

POST/v1/resolveOmfattning: lösa

Fält	Typ	Obligatoriskt	Beskrivning
`route_source`	HTTPS- URL	Ja	Offentlig eller auktoriserad mediesida att analysera.
`tenant`	sträng	Nej	Tilldelad hyresgästdomän. Vanligtvis utelämnad.

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

QuickT organiserar formatidentifierare kring det returnerade värdet oförändrat. Dess enhetsklara vy jämför tillgänglighet per länk. Ingen gissad kvalitetsetikett kvarstår som den slutgiltiga kontrollen.

Skapa och följ ett nedladdningsjobb

För att förklara Jobbskapande separerar QuickT asynkron förberedelse från en kort HTTP-förfrågan. En enhetsklar vy ger begränsad arbetsexekvering sin egen plats.

POST/v1/jobsOmfattning: jobb

Fält	Typ	Obligatoriskt	Beskrivning
`route_source`	HTTPS- URL	Ja	Samma normaliserade källa skickades in för att lösa.
`route_format`	sträng	Ja	Ett exakt ID från lösningssvaret.
`tenant`	sträng	Nej	Tilldelad hyresgästdomän. Vanligtvis utelämnad.

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 GodkändSpara route_job.

2OmröstningsstatusGET /v1/jobs/{route_job} med samma nyckel.

3KlarÖppna den signerade nedladdnings-URL:en.

Status	Betydelse	Klientåtgärd
`queued`	Antagen till den begränsade kön.	Rösta igen med fördröjning.
`extracting`	Uppdaterar källmetadata eller rutt.	Fortsätt med omröstningen.
`processing`	Laddar ner, remuxar eller slår ihop.	Visa serverns framsteg.
`ready`	Signerad nedladdning är tillgänglig.	Skicka URL:en till användaren.
`failed`	Terminal strukturerat fel.	Läs `error_code`. Försök igen endast när det rekommenderas.
`expired`	Tillfällig utdata togs bort.	Skapa ett nytt jobb.

curl https://quickt.io/v1/jobs/ROUTE_JOB \
  -H "X-API-Key: $QUICKT_ROUTE_TOKEN"

En initial väntetid på en sekund är startpunkten för jobb-polling på QuickT. En enhetsanpassad vy presenterar sedan begränsad backoff och förklarar temporär signerad leverans.

Förutsägbara fel

För felkontraktet börjar QuickT med ett kuvert som inte är 2xx. Dess enhet-klara vy parar ihop detta med en supportförfrågnings-ID och avslutas med förutsägbar klienthantering.

{
  "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 betydelse	Åtgärd
400	Ogiltig URL, innehåll eller otillgängligt format.	Korrigera förfrågan. Lös igen för format.
401	Saknad, ogiltig, utgången eller felaktig nyckel med fel behörighet.	Kontrollera serverns autentiseringsuppgifter.
403	Hyresgäst- eller källpolicy avvisade förfrågan.	Bryt inte mot policyn. Kontakta support.
404	Okänt eller utgånget jobb.	Skapa ett nytt jobb om det är lämpligt.
429	Begäran eller aktivt jobbgräns uppnådd.	Heder `retry_after_seconds`.
503	Kö/kapacitet eller upstream tillfälligt otillgänglig.	Försök igen med exponentiell backoff och jitter.

Driftkontrakt

QuickT väljer gränser för mobilklienter under godkännandet så att innehållsskaparnätverk och API:n förblir responsiva.

Använd idempotent programlogik och starta aldrig dubbla jobb för samma användarklick.
Cache lösa metadata kort, men alltid behandla signerade nedladdning webbadresser som löper ut.
Använd begränsad exponentiell backoff med jitter för 429, 503 och omförsökbara fel.
Bearbeta endast offentliga medier eller medier som du har behörighet att komma åt. DRM och åtkomstkontroller kringgås inte.
Spara begäran-ID och jobb-ID i privata driftloggar. Logga inte inskickade webbadresser i onödan.

För schemaåtkomst kontrollerar QuickT aktivering före utforskning före tilldelad autentisering. Denna enhetsanpassade vy gör också dokumenterade förfrågningsformat tydliga.

OPERATÖRSGRANSKAD ÅTKOMST

Aktivera via support

Beskriv mobilupplevelsen, dess trafikförväntningar och de skaparnätverk den behöver. QuickT använder den informationen för att tilldela analys- och köbehörigheter innan hemligheten avslöjas.

Begär aktivering av konto Nycklar är klientomfattande, återkalleliga och utfärdas via Kontaktformuläret. Anonyma skript kan inte utföra hämtningsarbete.