Numai previzualizare — activare necesară

Construiți descărcări cu QuickT

QuickT documentează modul în care un client mobil ar comunica cu serviciul. Nu poate trimite lucrări de producție până când suportul aprobă designul și activează accesul limitat.

QuicktRouteJSON prin HTTPSLocuri de muncă asincroneAcreditări cu domeniu

Start rapid

Pentru gazda API, QuickT verifică acreditările cu suport activat înaintea unui punct final de tenant atribuit. Această vizualizare pregătită pentru dispozitiv clarifică, de asemenea, o cale de apel numai de server.

URL- ul entității găzduitehttps://quickt.io

AutentificareX-API-Key: pending_activation_…

Profilul de clientQuicktRoute

Versiune 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 organizează securitatea credențialelor în jurul stocării secrete pe partea de server. Vederea sa pregătită pentru dispozitive compară lipsa încorporării pachetului client. Nu există jurnale publice sau depozite rămâne verificarea finală.

Rezolvarea unui link

Pentru operația Resolve, QuickT verifică detectarea sursei înainte de formate dintr-un singur URL trimis. Această vizualizare pregătită pentru dispozitiv nu clarifică nici ieșiri inventate.

POST/v1/resolveScop: rezolva

Câmp	Tip	Obligatoriu	Descrierea
`route_source`	URL HTTPS	Da.	Pagina media publică sau autorizată pentru a analiza.
`tenant`	șir	Nu.	Domeniul entității găzduite atribuite. De obicei omis.

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

QuickT organizează identificatorul Format în jurul valorii returnate, neschimbată. Vizualizarea sa pregătită pentru dispozitive compară disponibilitatea per link. Nicio etichetă de calitate ghicită nu rămâne verificarea finală.

Crearea și urmărirea unei lucrări de descărcare

Pentru a explica crearea jobului, QuickT separă pregătirea asincronă de o solicitare HTTP scurtă. O vizualizare pregătită pentru dispozitiv oferă execuției worker limitate propriul loc.

POST/v1/jobsDomeniul de aplicare: locuri de muncă

Câmp	Tip	Obligatoriu	Descrierea
`route_source`	URL HTTPS	Da.	Aceeași sursă normalizată prezentată pentru a rezolva.
`route_format`	șir	Da.	Un ID exact din răspunsul de rezolvare.
`tenant`	șir	Nu.	Domeniul entității găzduite atribuite. De obicei omis.

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 AcceptatSalvează route_job.

2Starea sondajuluiGET /v1/jobs/{route_job} cu aceeași cheie.

3Gata.Deschideți URL-ul de descărcare semnat.

Starea	Semnificație	Acțiune de client
`queued`	Admis în coada limitată.	Sondaj din nou cu backoff.
`extracting`	Reîmprospătarea metadatelor sursă sau a rutei.	Continuă să votezi.
`processing`	Descărcarea, remixarea sau îmbinarea.	Afișați progresul serverului.
`ready`	Descărcarea semnată este disponibilă.	Trimiteți URL-ul utilizatorului.
`failed`	Eroare structurată terminală.	Citiți `error_code`. Reîncercaţi numai atunci când este recomandat.
`expired`	Ieșirea temporară a fost eliminată.	Creați un loc de muncă nou.

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

Așteptarea inițială de o secundă este punctul de pornire pentru sondarea Job pe QuickT. O vizualizare pregătită pentru dispozitiv prezintă apoi o revenire graduală plafonată și explică livrarea temporară semnată.

Erori previzibile

Pentru contractul de eroare, QuickT începe cu un plic non-2xx. Vizualizarea sa pregătită pentru dispozitiv îl asociază cu un ID de solicitare de suport și se încheie cu o gestionare previzibilă a clientului.

{
  "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	Semnificație tipică	Acțiune
400	URL nevalid, corp sau format indisponibil.	Corectați solicitarea. Rezolvați din nou pentru formate.
401	Cheie lipsă, nevalidă, expirată sau cu domeniu incorect.	Verificați acreditările de pe partea serverului.
403	Politica chiriașului sau a sursei a respins solicitarea.	Nu ocoliți politica. Contactați asistența.
404	Loc de muncă necunoscut sau expirat.	Creați un nou loc de muncă, dacă este cazul.
429	A fost atinsă limita de solicitări sau de lucrări active.	Onoare. `retry_after_seconds`.
503	Coada/capacitatea sau sursa din amonte sunt temporar indisponibile.	Reîncercați cu backoff exponențial și jitter.

Contract de exploatare

QuickT alege limitele clientului mobil în timpul aprobării, astfel încât rețelele creatorilor și API-ul să rămână responsive.

Folosiți logică de aplicație idempotentă și nu porniți niciodată joburi duplicate pentru același clic al utilizatorului.
Stocați temporar metadatele rezolvate în cache, dar tratați întotdeauna URL-urile semnate de descărcare ca expirabile.
Utilizați backoff exponențial limitat cu jitter pentru 429, 503 şi erori reîncercabile.
Procesează doar media publică sau media la care ești autorizat să ai acces. DRM și controalele de acces nu sunt ocolite.
Păstrați ID-urile cererilor și ID-urile joburilor în jurnalele operaționale private. Nu înregistrați inutil URL-urile trimise.

Pentru accesul Schema, QuickT verifică activarea înainte de explorare, înainte de autentificarea atribuită. Această vizualizare pregătită pentru dispozitive clarifică și formele documentate ale cererilor.

ACCES REVIZUIT DE OPERATOR

Activați prin asistență

Descrie experiența mobilă, așteptările privind traficul și rețelele de creatori de care are nevoie. QuickT folosește aceste informații pentru a atribui permisiunile de analiză și de coadă înainte de a dezvălui secretul o singură dată.

Solicitați activarea Cheile sunt limitate la nivel de chiriaș, pot fi revocate și sunt emise prin formularul de contact. Scripturile anonime nu pot executa sarcini de descărcare.