Pouze náhled — vyžaduje aktivaci

Sestavte stahování s QuickT

QuickT dokumentuje, jak by mobilní klient komunikoval se službou. Nemůže odesílat produkční práci, dokud podpora neschválí návrh a nepovolí omezený přístup.

QuicktRouteJSON přes HTTPSAsynchronní úlohyPověření s rozsahem

Rychlý start

Pro hostitele rozhraní API QuickT kontroluje pověření aktivovaná podporou před přiřazeným koncovým bodem klienta. Toto zobrazení připravené pro zařízení také jasně ukazuje cestu volání pouze na serveru.

URL klientahttps://quickt.io

AutentizaceX-API-Key: pending_activation_…

Profil klientaQuicktRoute

Verze 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 organizuje bezpečnost přihlašovacích údajů kolem serverového ukládání tajemství. Jeho pohled připravený pro zařízení porovnává žádné vkládání klientského balíčku. Žádné veřejné protokoly ani repozitáře nezůstávají poslední kontrolou.

Vyřešit odkaz

Pro operaci Resolve kontroluje QuickT detekci zdroje před formáty z jednoho odeslaného URL. Tento pohled připravený pro zařízení také jasně zobrazuje žádné vymyšlené výstupy.

POST/v1/resolveRozsah: vyřešit

Pole	Typ	Povinné	Popis
`route_source`	HTTPS	Ano	Veřejná nebo autorizovaná mediální stránka k analýze.
`tenant`	řetězec	Ne.	Přiřazená doména klienta. Obvykle se vynechává.

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

QuickT organizuje identifikátor formátu kolem vrácené hodnoty beze změny. Jeho zobrazení připravené pro zařízení porovnává dostupnost po jednotlivých odkazech. Žádný odhadovaný štítek kvality už nezůstává závěrečnou kontrolou.

Vytvoření a sledování úlohy stahování

Pro vysvětlení vytváření úlohy, QuickT odděluje asynchronní přípravu od krátkého požadavku HTTP. Device-ready view dává bounded worker execution jeho vlastní místo.

POST/v1/jobsRozsah: pracovní místa

Pole	Typ	Povinné	Popis
`route_source`	HTTPS	Ano	Stejný normalizovaný zdroj předložený k vyřešení.
`route_format`	řetězec	Ano	Přesné ID z odpovědi na překlad.
`tenant`	řetězec	Ne.	Přiřazená doména klienta. Obvykle se vynechává.

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 PřijatoSave route_job.

2Stav hlasováníGET /v1/jobs/{route_job} se stejným klíčem.

3PřipravenOtevřete podepsanou adresu URL ke stažení.

Stav	Význam	Akce klienta
`queued`	Připuštěn do ohraničené fronty.	Anketa znovu s backoff.
`extracting`	Obnovování zdrojových metadat nebo trasy.	Pokračujte v hlasování.
`processing`	Stahování, remixování nebo slučování.	Zobrazit průběh serveru.
`ready`	Podepsané stažení je k dispozici.	Odešlete uživateli adresu URL.
`failed`	Chyba struktury terminálu.	Přečtěte si `error_code`Zkuste to znovu pouze v případě, že je to doporučeno.
`expired`	Dočasný výstup byl odstraněn.	Vytvořte novou úlohu.

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

Jednosekundová počáteční čekací doba je výchozím bodem pro polling úlohy na QuickT. Poté se zobrazí pohled připravenosti zařízení, který předkládá omezený backoff a vysvětluje dočasné podepsané doručení.

Předvídatelné chyby

Pro chybovou smlouvu QuickT začíná jedním obalem mimo 2xx. Jeho zobrazení připravené pro zařízení to páruje s ID žádosti o podporu a končí předvídatelným zpracováním na straně klienta.

{
  "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": "…"
}

Hypertext Transfer Protocol	Typický význam	Akce
400	Neplatná adresa URL, tělo nebo nedostupný formát.	Opravte požadavek. Znovu vyřešte formáty.
401	Chybějící, neplatný, vypršený nebo nesprávný rozsah klíče.	Zkontrolujte pověření na straně serveru.
403	Klient nebo zdrojové zásady požadavek zamítly.	Nepřekračujte pravidla. Kontaktujte podporu.
404	Neznámá nebo vypršela pracovní pozice.	V případě potřeby vytvořte novou úlohu.
429	Dosáhli jste limitu požadavků nebo aktivních úloh.	Honor `retry_after_seconds`.
503	Fronta/kapacita nebo upstream dočasně nedostupné.	Zkuste to znovu s exponenciálním zpětným odstupem a jitterem.

Provozní smlouva

QuickT volí limity mobilního klienta během schvalování, aby zůstaly sítě tvůrců a API responzivní.

Používejte idempotentní aplikační logiku a nikdy nespouštějte duplicitní úlohy pro stejné uživatelské kliknutí.
Cache krátce vyřeší metadata, ale vždy považuje podepsané adresy URL ke stažení za vypršení platnosti.
Použijte ohraničený exponenciální backoff s jitter pro 429, 503 a opakovatelné chyby.
Zpracovávejte pouze veřejná média nebo média, ke kterým máte oprávnění. DRM a přístupová omezení nejsou obcházena.
ID požadavků a ID úloh uchovávejte v soukromých provozních protokolech. Nezapisujte do protokolů odeslané adresy URL zbytečně.

Pro přístup ke schématu QuickT kontroluje aktivaci před průzkumem a před přiřazeným ověřením. Toto zobrazení připravené pro zařízení také zpřehledňuje zdokumentované tvary požadavků.

PŘÍSTUP PŘEZKOUMANÝ OPERATOREM

Aktivace prostřednictvím podpory

Popište mobilní zážitek, očekávanou návštěvnost a sítě tvůrců, které potřebuje. QuickT tyto informace používá k přiřazení oprávnění k analýze a frontě před jednorázovým odhalením tajemství.

Požádat o aktivaci Klíče jsou omezeny na klienta, lze je odvolat a vydávají se prostřednictvím kontaktního formuláře.