added
Model kľúča na nasadenie, kde bearer token JE projekt. Na ňom bežia CLI aj GitHub Action.
api v1 · aktuálne
Zoznam zmien API.
Nič nebolo odstránené.
/v1 iba pribúda. Nové endpointy a nové polia odpovedí prichádzajú pod rovnakým prefixom a pole, ktoré už parsujete, nikdy nemení tvar ani nezmizne. Zlomová zmena by bola vydaná pod novým verzným prefixom, ktorý je rezervovaný a zatiaľ prázdny.
v1/api/v1
jediný používaný prefix
jediný používaný prefix
5 vydaní
11 zmien, žiadna z nich nie je zlomová
tvar záznamu
Jeden verzný prefix, bez odstránení.
Tri z týchto štyroch sú vlastnosťami tohto záznamu samotného. Štvrtou je veľkosť katalógu webhookov, ktoré API poskytuje.
5
vydania na /v1, každé z nich je aditívne
1
používaný verzný prefix. Ďalší je rezervovaný a prázdny
0
zlomové zmeny od vydania API
12
podpísané udalosti webhookov. Zdroj: App\Enums\WebhookEvent
datované podľa vydania, nie podľa semver
použite šípky na navigáciu
2026-07-08
Doručovanie CDN, využitie a playground
July 8, 2026 · 4 zmien
05 / 05
added
/v1/incontext/translations, /screenshots a /suggest poháňajú vizuálny editor, pričom CORS je obmedzené na tento prefix a nič iné.
POST /v1/incontext/session vymení publikovateľný kľúč a Origin za token relácie s obmedzeným rozsahom.
improved
Dvojjazyčný export teraz hlási, čo sa nepodarilo preniesť späť, namiesto tichého nahradenia zdrojovým textom. Existujúce polia zostávajú nezmenené, čo je hlavný dôvod umiestnenia do hlavičky.
GET /v1/pull získal hlavičky odpovede X-Skipped-Keys a X-Missing-Source-Keys.
added
Plus /v1/glossary/import, /export a /extract, takže termínovú základňu možno presunúť dnu a von bez otvorenia konzoly.
Plnohodnotné CRUD operácie pre termínovú základňu cez API: GET, POST, PUT a DELETE na /v1/glossary.
added
Nálezy sa objavia v riadkoch prekladov, ktoré už sťahujete, takže nie je potrebné dotazovať nič nové.
POST /v1/qa/run spustí agentickú kontrolu kvality a vráti identifikátor behu.
added
Prihláste sa na odber podľa koncového bodu. Zoznam sa nachádza v App\Enums\WebhookEvent, ktorý dnes obsahuje dvanásť prípadov; počítajte enum, nie tento riadok.
Podpísané webhooky emitujú udalosti kľúčov, prekladov, jazykov, glosára a QA spolu s pôvodným párom dávky.
improved
Doručenie obsahuje počet a až dvadsať vzoriek namiesto jedného volania na každý zmenený riadok. Logy doručenia zaznamenávajú každý pokus s časom ďalšieho opakovania.
Vysokofrekvenčné udalosti, ako napríklad translation.updated, sú zlučované do jedného doručenia za okno, takže hromadná úprava nikdy nezaplaví koncový bod.
added
Vracia ETag a krátkodobú cache a rešpektuje If-None-Match s 304. Nemenný súrodenec pod /v{n} je adresovaný obsahom a cachovaný jeden rok.
Verejný, edge-cacheovateľný GET /v1/cdn/{project}/{locale} poskytuje vaše publikované reťazce.
added
Spustite ho v CI pomocou POST /v1/cdn/publish a autorizujte čítanie vyhradeným kľúčom len na čítanie v hlavičke X-Transglot-Cdn-Key. Bezpečné na umiestnenie za vlastnú CDN.
Publikovanie povyšuje aktuálne preklady na novú nemennú verziu, manuálne alebo pri každom pushnutí.
added
Žiadne telá požiadaviek sa neukladajú. Je to iba počítadlo a nič viac.
Každé autentifikované volanie /v1 sa počíta za token za deň a zobrazuje sa v hub-e nasadenia.
improved
Projekt, pull, dávky a export glosára. Žiadny tvar požiadavky ani odpovede sa nezmenil, aby to fungovalo.
Hub nasadenia získal API playground, ktorý spúšťa koncové body len na čítanie live voči vášmu projektu.
register zastaraných funkcií
Nič nie je bude odstránené.
Jeden riadok pre každý publikovaný povrch s vydaním, v ktorom bol zahrnutý. Posledný stĺpec je ten, ktorý treba sledovať: odstránenie by sa tam objavilo s dátumom dlho pred tým, než k nemu skutočne došlo.
| Povrch | Vydanie | Stav | Dátum odstránenia |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | aktuálne | žiadne naplánované |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | aktuálne | žiadne naplánované |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | aktuálne | žiadne naplánované |
POST /v1/qa/run | June 12, 2026 | aktuálne | žiadne naplánované |
Signed webhook events, twelve typed cases | June 30, 2026 | aktuálne | žiadne naplánované |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | aktuálne | žiadne naplánované |
Riadok sa z tejto tabuľky nikdy neodstraňuje. Ak je povrch vyradený, zachová si svoj riadok a pribudne mu dátum, pretože odstránenie, proti ktorému sa môžete pripraviť, je hlavným dôvodom jeho zverejnenia.
záväzok kompatibility
Tri pravidlá na ktorých môžete stavať.
prírastkové
Nové koncové body a nové polia odpovedí sa vydávajú v rámci /v1. Pole, ktoré už analyzujete, nemení svoju štruktúru ani nezmizne.
nový prefix
Zásadná zmena by bola vydaná pod novým verzným prefixom, nie v rámci tejto verzie. Tento prefix je rezervovaný a nepoužitý; všetky doterajšie vydania spadajú pod v1.
úprimné hlavičky
Ak pull request nedokáže niečo správne spracovať späť, oznámi to v hlavičke. Pridali sme hlavičky X-Skipped-Keys a X-Missing-Source-Keys namiesto zmeny tela odpovede bez upozornenia.
Často kladené otázky
Čo sa vývojári pýtajú na verzovanie API a ukončovanie podpory.
Je API Transglot verzované?
Áno, podľa prefixu URL. Všetko doteraz publikované je dostupné pod /v1, čo je jediný používaný prefix. Neexistuje žiadna verzná hlavička, žiadne pripínanie k dátumu ani nič na konfiguráciu.
Môže aktualizácia niekedy rozbiť moju integráciu?
Nie v rámci /v1. Pridávajú sa nové endpointy a nové polia odpovedí, ale pole, ktoré už parsujete, nemení štruktúru ani nezmizne. Ak by zmena nemohla byť vykonaná aditívne, prebehla by pod novým prefixom a starý by fungoval ďalej.
Bolo niečo označené ako zastarané alebo odstránené?
Nič, a vyššie uvedený register to potvrdzuje riadok po riadku. Každý publikovaný povrch je uvedený s vydaním, v ktorom bol nasadený, a stĺpcom odstránenia, ktorý momentálne všade uvádza „nie je plánované“.
Koľko času vopred by bolo oznámené odstránenie?
Odstránenie by sa v registri objavilo s dátumom dlho predtým, než by k nemu došlo, a riadok by v tabuľke zostal aj následne, namiesto toho, aby zmizol. Dátum, podľa ktorého sa môžete plánovať, je hlavným dôvodom jeho zverejnenia.
Ako zistím, keď je vydaná nová funkcia?
Každé vydanie je na tejto stránke datované. Produktový changelog pokrýva všetko ostatné, čo je vydané, a konzola zobrazuje značku, keď je niečo, čo ste ešte nečítali.
Prečo existuje samostatný zoznam zmien pre API?
Pretože API prináša záväzok spätnej kompatibility, ktorý bežné vydanie produktu nemá. Vývojár, ktorý kontroluje, či integrácia stále funguje, by nemal musieť hľadať medzi novými funkciami.
Ako si pridám API do svojho plánu?
Bearer token je dostupný v rámci plánu Starter za 19 USD mesačne. Bezplatná verzia pokrýva konzolu, ale neumožňuje vytvoriť token. CLI, GitHub Action, webhooks a MCP sú viazané na tento token.
Kde nájdem referenciu pre jednotlivé endpointy?
Na stránke API: autentifikácia, endpointy, rate limit, formáty súborov a katalóg webhookov. Táto stránka slúži len ako záznam o tom, čo sa zmenilo a kedy.
funguje s tým, čo už používate
41 konektorov, už vytvorených.
zmluva je produkt
Stavajte na API ktorá sa nemení.
API je dostupné v pláne Starter a vyšších. Bezplatný plán stojí 0 USD a ponúka 100 000 slov na začiatok (25 000 pri registrácii, 75 000 po overení telefónnym číslom), následne 10 000 mesačne, bez prístupu k API a webhookom.