Automatizujte Transept pomocí API

Osobní API klíč si vytvoříte v sekci Nastavení → Vývojář. Je k dispozici v každém tarifu, včetně verze Free – neexistují žádná jiná omezení, využití limituje pouze vaše bilance Wörter. Klíč pojmenujte, volitelně nastavte konec platnosti a po zobrazení si zkopírujte tajný kód (secret): zobrazí se pouze jednou a později jej už nelze získat. Klíč můžete kdykoli zneplatnit na stejné stránce.

Požadavky se autentizují pomocí klíče v hlavičce Authorization: Bearer tsk_live_… – pouze v hlavičce, nikdy v URL.

Vytvořte dokument z prostého textu, HTML nebo markdownu, nebo nahrajte soubor – aplikace přijímá stejné formáty. Můžete také importovat tabulku řetězců (.tstrings.json): strukturovaný formát pro texty uživatelského rozhraní nebo herní řetězce, kde je každý řetězec jednotkou se stálým klíčem a vlastním kontextem – poznámkou o tom, co to je, kde se to objevuje, limitem znaků a významem zástupných symbolů. To vše se dostane k modelu, zástupné symboly jako {name} jsou chráněny před odstraněním nebo přejmenováním a množná čísla se rozbalí podle jazyka (jeden anglický tvar se v němčině změní na dva, v ukrajinštině na čtyři). Jakékoli překlady, které soubor již obsahuje, se importují tak, jak jsou, zdarma a okamžitě plní překladovou paměť.

Hromadné spuštění překládá do několika jazyků najednou. Zadejte název dokumentu, Workflow nebo šablonu ke spuštění a cílové jazyky; Transept vytvoří chybějící jazykové verze a v každé z nich Workflow spustí. Celý proces sledujete pod jedním ID – dotazováním na něj zjistíte postup u jednotlivých jazyků i to, zda se čeká na kontrolu.

Při opakovaných spuštěních znovu odešlete aktuální soubor tabulky řetězců a Transept sám rozpozná, co se změnilo: u nezměněných řetězců zůstanou zachovány překlady (i případné hotové kontroly) a spuštění se dotkne pouze nových nebo skutečně změněných jednotek – jde o API variantu funkce Spouštět pouze změny. Volání vytvářející úlohu navíc přijímá hlavičku Idempotency-Key, takže opakovaný pokus po krátkém výpadku sítě vrátí původní výsledek namísto vytvoření druhého dokumentu a dalšího účtování.

Místo neustálého dotazování (polling) si zaregistrujte URL adresu a Transept vám sám odešle událost, jakmile spuštění skončí nebo selže, když je připravena kontrola, když se dokončí zpracování nahraného souboru nebo když je připraven export. Každé doručení obsahuje hlavičku HMAC-SHA256 X-Transept-Signature: t=…,v1=…, aby váš přijímač mohl ověřit, že zpráva skutečně přišla od nás. Pokud koncový bod selhává, systém zkouší doručení opakovaně s prodlevou (backoff), než jej deaktivuje.

Workflow se může spustit i automaticky pomocí automatizace databáze v Notion: nasměrujte webhook automatizace na URL spouštěče a Transept spustí Workflow na stránce, která se změnila. Má to ale háček: webhook z Notion nikdy nepřenáší samotný obsah stránky – pouze uvádí, která stránka akci vyvolala. Transept si tuto stránku načítá přes vaše propojení s Notion, takže musí být splněny dvě podmínky. V opačném případě bude každé spuštění odmítnuto s chybou přístupu a na kartě spouštěče se zobrazí poznámka „nepodařilo se načíst stránku z Notion“:

• Propojte Notion v Transeptu – v sekci Nastavení → Integrace. Jde o jednorázové propojení přes OAuth, které Transeptu umožní číst data vaším jménem.
• Nasdílejte zdrojovou databázi integraci přímo v Notion – otevřete databázi (nebo stránku), klikněte na nabídku •••, zvolte Connections a přidejte Transept. Samotné propojení Notion v Nastavení neuděluje přístup ke konkrétní databázi automaticky; bez tohoto kroku sice spojení funguje, ale stránka zůstane nečitelná.
• Spouštějte akce změnou vlastnosti, nikoli jen úpravou obsahu. Automatizace v Notion se aktivují při změně vlastnosti (nebo přidání stránky), takže samotná úprava textu na stránce nemusí nic spustit. Spolehlivým řešením je sledování vlastnosti Status – stačí ji přepnout (např. na „Ready to translate“) a právě tato změna aktivuje spouštěč.

Kompletní seznam koncových bodů je k dispozici jako specifikace OpenAPI, kterou můžete importovat do n8n, Zapieru nebo generátoru kódu: prohlédnout si ji můžete na adrese /public/v1/docs svého Transept API nebo si stáhnout čistý soubor JSON na /public/v1/openapi.json. Spuštění zahájená přes API účtují Wörter úplně stejně jako editor v aplikaci.