Pro vývojáře
K diktuj.to můžete připojit vlastní skript nebo asistenta. Pro přístup ke své historii si vytvořte osobní token v účtu. Serverovou historii je potřeba nejdřív zapnout.
Dva druhy přístupu
Osobní API token vytvoříte v účtu → Tokeny. Umožňuje číst Vaši historii a spotřebu, upravovat slovník a zkratky nebo mazat historii. Nemůže měnit souhlas s ukládáním historie ani spravovat zařízení a další tokeny. Bez oprávnění imports jej brána zatím nepouští na placený přepis nahrávek. S oprávněním „Povolit přepis nahrávek“ může osobní token spustit také účtovaný import.
Token zařízení získá aplikace při párování. Používá jej pro diktování, nahrávky a schůzky. Tokeny se zobrazí jen při vydání; ztracený token odvolejte a vytvořte nový. Do skriptu používejte osobní token s omezeným přístupem.
Asistenti, terminál a webhooky
Připojení přes MCP pro Claude Code, Claude Desktop a Codex připravujeme k veřejnému vydání. Instalační balíček ani veřejný návod zatím nejsou dostupné jako samostatné vydání. Postup pro uživatele se zdrojovým kódem najdete na stránce Integrace. Vzdálené připojení z ChatGPT zatím není připravené.
Nástroj diktuj pro terminál připravujeme k veřejnému vydání. Balíček zatím není publikovaný na npm. Přepis souboru osobním tokenem vyžaduje oprávnění imports, které zvolíte při vytvoření tokenu.
Odchozí webhooky doručují podepsané události na Vaši adresu. Ověření podpisu a omezení doručování popisuje stránka Integrace.
Katalog přepisů a souhlas s historií
Následující popis odpovídá připravované verzi API. Její nasazení zatím není potvrzené. Pro vývoj používejte místní testovací sestavu.
GET /v1/catalog
S Bearer tokenem zařízení nebo osobním API tokenem načtete položky svého účtu. Parametr after je nezáporný BIGINT zapsaný jako desetinný řetězec (výchozí 0), limit je 1–200 (výchozí 100). Odpověď 200 obsahuje items, řetězec next_cursor a has_more; položky řadí vzestupně podle revision. Celé nové položky ukládejte současně s kurzorem a načítejte další stránky, dokud je has_more pravda. Záznam smazání má stav deleted a prázdný payload. Novým obsahem vždy nahraďte starý, i když je prázdný; po změně účtu použijte jinou cache a kurzor. Vadný dotaz vrací 400, chybějící nebo neplatný token 401. Importy a schůzky se v katalogu objeví až po dokončení jejich napojení.
DELETE /v1/catalog/:id
Bearer token zařízení nebo osobní API token dovoluje smazat pouze položku Vašeho účtu. Vlastní známé ID, včetně již smazaného, vrací 204 bez těla; cizí či neznámé ID vrací 404 a vadné UUID 400. Obsah nahradí trvalý záznam smazání s vyšší revision, který při další synchronizaci převezmou i offline zařízení. Diktát se smaže také z původní historie. Pozdní opakování zápisu stejného zdrojového ID položku neobnoví. Mazání samotného audia importů a schůzek zajišťuje přepisovací služba; napojení musí stejný záznam smazání respektovat i při čtení výsledku.
PUT /v1/history/enabled
Souhlas s ukládáním serverové historie mění pouze Bearer token zařízení, osobní API token jej měnit nesmí. Tělo {"enabled":true} historii zapne, {"enabled":false} ji vypne. Odpověď 200 vrací enabled jako boolean; vadné tělo vrací 400 a chybějící profil 409 profil_neexistuje. Text nových diktátů se ukládá jen při zapnuté volbě. Vypnutí samo fyzicky nemaže staré přepisy. Katalog při přepnutí vydá nové revision a při vypnutí neposílá text, aby klient nahrazením celé položky odstranil dříve synchronizovaný obsah ze své serverové cache.
Podrobný popis API
Veřejnou dokumentaci cest, těl požadavků, chybových kódů a limitů připravujeme. Interní vývojová dokumentace zatím není veřejně dostupná.
OAuth pro cizí aplikace ani testovací tokeny se zatím nevydávají. Osobní token chraňte jako heslo: dává přístup k Vašim textům a části nastavení.