added
Model deployovacího klíče, kde bearer token JE projekt. Na něm běží jak CLI, tak GitHub Action.
api v1 · aktuální
Changelog API.
Nic neodstraněno.
/v1 pouze získává věci. Nové endpointy a nová pole odpovědí přicházejí v rámci stejného prefixu a pole, která již parsujete, nikdy nemění tvar ani nezmizí. Změna s dopadem na kompatibilitu by byla vydána pod novým prefixem verze, který je rezervován a zatím prázdný.
v1/api/v1
jediný používaný prefix
jediný používaný prefix
5 vydání
11 změn, žádná z nich není nekompatibilní
tvar logu
Jeden prefix verze, žádná odstranění.
Tři z těchto čtyř jsou vlastnosti tohoto logu samotného. Čtvrtým je velikost katalogu webhooků, které API poskytuje.
5
vydání na /v1, každé z nich je rozšiřující
1
používaný prefix verze. Další je rezervovaný a prázdný
0
nekompatibilní změny od spuštění API
12
podepsané události webhooků. Zdroj: App\Enums\WebhookEvent
datováno podle vydání, nikoli podle semver
k pohybu použijte šipky
2026-07-08
Doručování CDN, využití a playground
July 8, 2026 · 4 změn
05 / 05
added
/v1/incontext/translations, /screenshots a /suggest pohánějí vizuální editor, přičemž CORS je omezeno pouze na tento prefix a nic jiného.
POST /v1/incontext/session vymění publikovatelný klíč a Origin za token relace s omezeným rozsahem.
improved
Dvojjazyčný export nyní hlásí, co se nepodařilo převést zpět, místo tichého dosazení zdrojového textu. Existující pole zůstávají nezměněna, což je celý smysl umístění do hlavičky.
GET /v1/pull získalo odpovědní hlavičky X-Skipped-Keys a X-Missing-Source-Keys.
added
Plus /v1/glossary/import, /export a /extract, takže lze terminologickou databázi přesouvat bez otevření konzole.
Plné CRUD operace nad terminologickou databází prostřednictvím API: GET, POST, PUT a DELETE na /v1/glossary.
added
Nálezy se objevují v řádcích překladů, které již stahujete, takže není třeba dotazovat nic nového.
POST /v1/qa/run spustí agentní kontrolu kvality a vrátí identifikátor běhu.
added
Přihlaste se k odběru podle koncového bodu. Seznam samotný se nachází v App\Enums\WebhookEvent, který dnes obsahuje dvanáct případů; počítejte enum místo tohoto řádku.
Podpisované webhooky emitují události klíčů, překladů, jazyků, glosářů a QA alongside původního páru dávek.
improved
Doručení nese počet a až dvacet ukázek namísto jednoho volání na každý změněný řádek. Logy doručení zaznamenávají každý pokus s časem dalšího opakování.
Vysoce frekventované události, jako je translation.updated, jsou slučovány do jednoho doručení za okno, takže hromadná úprava nikdy nezahlcuje koncový bod.
added
Vrací ETag a krátkodobou cache a respektuje If-None-Match s kódem 304. Neměnný sourozenec pod /v{n} je adresován obsahem a cachován po dobu jednoho roku.
Veřejný, edge-cacheovatelný GET /v1/cdn/{project}/{locale} poskytuje vaše publikované řetězce.
added
Spusťte jej v CI pomocí POST /v1/cdn/publish a autorizujte čtení vyhrazeným klíčem pouze pro čtení v hlavičce X-Transglot-Cdn-Key. Bezpečné umístit za vlastní CDN.
Publikování povyšuje aktuální překlady do nové neměnné verze, ručně nebo při každém pushi.
added
Žádná těla požadavků nejsou ukládána. Je to pouze počet a nic jiného.
Každé autentizované volání /v1 se počítá denně na token a zobrazuje se na deploy hubu.
improved
Projekt, pull, dávky a export glosáře. Žádný tvar požadavku ani odpovědi se nezměnil, aby to fungovalo.
Deploy hub získal API playground, který spouští koncové body pouze pro čtení živě proti vašemu projektu.
registr zastarání
Nic není mizí.
Jeden řádek na publikovaný povrch s verzí, která jej dodala. Poslední sloupec je ten, na který si dát pozor: odstranění by se tam objevilo s datem dlouho předtím, než k němu došlo.
| Povrch | Dodáno | Stav | Datum odstranění |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | aktuální | nic naplánováno |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | aktuální | nic naplánováno |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | aktuální | nic naplánováno |
POST /v1/qa/run | June 12, 2026 | aktuální | nic naplánováno |
Signed webhook events, twelve typed cases | June 30, 2026 | aktuální | nic naplánováno |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | aktuální | nic naplánováno |
Řádek se z této tabulky nikdy neodstraňuje. Pokud je povrch vyřazen, zachová si svůj řádek a získá datum, protože možnost plánovaného odstranění je hlavním důvodem jeho publikování.
záruka kompatibility
Tři pravidla na kterém můžete stavět.
aditivní
Nové koncové body a nová pole odpovědí jsou přidávány v rámci /v1. Pole, která již parsujete, nemění svou strukturu ani nezmizí.
nový prefix
Změna narušující zpětnou kompatibilitu by byla vydána pod novým prefixem verze, nikoliv uvnitř této. Tento prefix je rezervován a nepoužíván a každé vyšší vydání spadalo pod v1.
upřímné hlavičky
Pokud pull request nedokáže něco obousměrně synchronizovat, oznámí to v hlavičce. Hlavičky X-Skipped-Keys a X-Missing-Source-Keys byly přidány, místo aby se měnilo tělo odpovědi pod vámi.
Často kladené dotazy
Co vývojáři nejčastěji žádají ohledně verzování API a ukončování podpory.
Je rozhraní Transglot API verzováno?
Ano, podle prefixu URL. Všechny dosud publikované verze jsou dostupné pod /v1, což je jediný používaný prefix. Neexistuje žádná hlavička pro verzi, žádné připnutí k datu ani nic ke konfiguraci.
Může aktualizace někdy rozbít mou integraci?
Ne v rámci /v1. Přibývají nové koncové body a nová pole odpovědí, ale pole, která již parsujete, nemění strukturu ani nezmizí. Pokud by změna nešla provést aditivně, byla by umístěna pod nový prefix a starý by nadále fungoval.
Bylo něco zastaralé nebo odstraněno?
Nic, a výše uvedený registr to potvrzuje řádek po řádku. Každá publikovaná část rozhraní je uvedena s vydáním, ve kterém byla nasazena, a sloupcem pro odstranění, který všude uvádí „nic naplánováno“.
Jak dlouhá by byla lhůta před odstraním?
Odstranění by se v tomto registru objevilo s datem dlouho předtím, než by k němu došlo, a řádek by v tabulce zůstal i poté, místo aby zmizel. Datum, podle kterého se lze plánovat, je hlavním důvodem jeho zveřejnění.
Jak zjistím, kdy vychází něco nového?
Každé vydání je na této stránce datováno. Produktový changelog pokrývá vše ostatní, co je nasazeno, a konzole zobrazuje značku, když je něco, co jste ještě nečetli.
Proč existuje samostatný changelog pro API?
Protože API nese příslib kompatibility, který produktové vydání nemá. Vývojář kontrolující, zda integrace stále funguje, by neměl muset listovat přes práce na funkcích, aby to zjistil.
Jak přidám API do svého plánu?
Bearer token začíná u plánu Starter za 19 $ měsíčně. Bezplatná verze pokrývá konzoli, ale neumožňuje vytvořit token, a CLI, GitHub Action, webhooky a MCP jsou všechny chráněny tímto stejným tokenem.
Kde najdu referenci pro samotné koncové body?
Na stránce API: autentizace, koncové body, limit rychlosti, formáty souborů a katalog webhooků. Tato stránka je pouze záznamem toho, co se změnilo a kdy.
funguje s tím, co již používáte
41 konektorů, již připraveno.
smlouva je produktem
Vytvářejte na API který se nehýbe.
API je dostupné v plánu Starter a vyšších. Zdarma je 0 $ s 100 000 slovy na začátek (25 000 při registraci, 75 000 po ověření telefonem), poté 10 000 měsíčně a bez API nebo webhooků.