Pouze náhled — vyžaduje aktivaci

Sestavte stahování s DWTT

DWTT zveřejňuje tento přehled integrace pro plánování, nikoli pro anonymní spouštění. Podpora musí nejprve schválit postup zpracování klipů; teprve poté vydá klíč s vymezenými oprávněními a přiděleným limitem provozu.

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

Rychlý start

DWTT přehledně vysvětluje hostitele API. Stránka začíná přístupovými údaji aktivovanými podporou, pokračuje přiděleným koncovým bodem pro daného zákazníka a jasně uvádí, že volání probíhají pouze ze serveru.

URL klientahttps://dwtt.app

AutentizaceX-API-Key: pending_activation_…

Profil klientaDwttToolkit

Verze APIv1

# Available only after support activation
export DWTT_TOOL_TOKEN="issued-after-review"

curl -X POST https://dwtt.app/v1/resolve \
  -H "X-API-Key: $DWTT_TOOL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"source_link":"https://www.youtube.com/watch?v=VIDEO_ID"}'

Ochrana přístupových údajů ve službě DWTT začíná uložením tajných údajů na serveru a pokračuje zákazem jejich vkládání do klientského balíčku. Zjednodušený postup výslovně vylučuje jejich zveřejnění v protokolech nebo repozitářích.

Vyřešit odkaz

DWTT přehledně vysvětluje operaci rozpoznání odkazu. Stránka začíná rozpoznáním zdroje, pokračuje formáty pro jednu odeslanou URL a jasně uvádí, že výstupy se nevymýšlejí.

POST/v1/resolveRozsah: vyřešit

Pole	Typ	Povinné	Popis
`source_link`	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
}

U identifikátoru formátu vychází DWTT z nezměněné vrácené hodnoty a následně z dostupnosti pro konkrétní odkaz. Zjednodušený postup výslovně uvádí, že označení kvality se neodhaduje.

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

Při vysvětlování vytváření úloh začíná DWTT asynchronní přípravou. Zjednodušený postup pokračuje krátkým požadavkem HTTP a končí časově či jinak omezeným zpracováním pracovníkem.

POST/v1/jobsRozsah: pracovní místa

Pole	Typ	Povinné	Popis
`source_link`	HTTPS	Ano	Stejný normalizovaný zdroj předložený k vyřešení.
`format_ref`	ř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://dwtt.app/v1/jobs \
  -H "X-API-Key: $DWTT_TOOL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"source_link":"https://www.youtube.com/watch?v=VIDEO_ID","format_ref":"18"}'

1202 PřijatoSave task_ref.

2Stav hlasováníGET /v1/jobs/{task_ref} 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://dwtt.app/v1/jobs/TASK_REF \
  -H "X-API-Key: $DWTT_TOOL_TOKEN"

Při vysvětlování dotazování na stav úlohy rozlišuje DWTT počáteční čekání jednu sekundu a postupné prodlužování intervalů až do stanoveného limitu. Zjednodušený postup samostatně popisuje dočasné podepsané doručení.

Předvídatelné chyby

Výchozím bodem pro smluvenou podobu chyb ve službě DWTT je jednotný obal odpovědí se stavem mimo rozsah 2xx. Zjednodušený postup dále uvádí identifikátor požadavku pro podporu a vysvětluje předvídatelné zpracování 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

DWTT nastavuje limity provozu během aktivace, aby nedocházelo k přetížení integrací klipů a zdrojových sítí.

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ě.

DWTT přehledně vysvětluje přístup ke schématu. Stránka začíná aktivací před procházením, pokračuje přidělenými ověřovacími údaji a jasně uvádí zdokumentované podoby požadavků.

PŘÍSTUP PŘEZKOUMANÝ OPERATOREM

Aktivace prostřednictvím podpory

Sdělte službě DWTT plánovanou integraci, očekávaný počet požadavků a cílové sítě. Uveďte, zda klient potřebuje rozpoznávání odkazů, vytváření úloh, nebo obojí, aby bylo možné schválit klíč s vymezenými oprávněními a jednorázově jej zobrazit.

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