api.transglot.ai/v1bearer token, jeden projektreferencia

Odošlite súbor. Dostanete späť každý jazyk.

REST API na preklad vašej aplikácie. Jedným POST požiadavkou nahráte zdrojový súbor, jedným GET získate hotovú lokalizáciu a bearer token predstavuje celú autentifikáciu. Môže ho používať čokoľvek, čo komunikuje cez HTTP.

za: jedno volanie

curl -X POST https://api.transglot.ai/v1/push \

-H "Authorization: Bearer $TRANSGLOT_TOKEN" \

-F "file=@lang/en.json" \

-F "format=laravel_json"

202 accepted · batch queued

von

300,000

slov mesačne na pláne Starter, prvý plán, ktorý umožňuje vytvoriť token.

Začať zdarma Pozrieť rozhranie pre vývojárov

60 požiadaviek za minútu na token · každá odpoveď 429 obsahuje hlavičku Retry-After · používajte samostatné tokeny pre CI a produkciu

konzola je klient API

Push, preklad, brány a pull, každý ako REST endpoint.

Každý riadok na obrázku nižšie má za sebou trasu: push, brány, glosár, dávky a pull, všetky dostupné z vášho vlastného kódu pomocou projektového tokenu. Hracie prostredie API v konzole spúšťa tie určené len na čítanie live proti vášmu projektu, takže najprv uvidíte skutočnú odpoveď.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Nahráte zdrojový súbor
POST/v1/push
Panel brán sa vyplní
POST/v1/qa/run
Uzamknete termín
POST/v1/glossary
Zobrazenie dávky sa samo dotazuje
GET/v1/batches/:id
Preberiete preklady späť
GET/v1/pull

jedna trasa na panel, 60 za minútu, oprávnenia podľa tokenu · získanie vašich prekladov je tiež endpoint

je to len HTTP

Štyri veci, ktoré tímy budujú ako prvé.

každá je jeden endpoint a projektový token · žiadna nezaberie celé popoludnie

merge gate · jeden súbor workflow

Označte pull request ako červený, keď preklad zlyhá.

cron · každú noc

Prekladajte poznámky k vydaniu cez noc, každú noc.

bot · jedno predplatné

Odoslať do Slacku hneď, ako sa dávka dokončí.

agent · MCP

Poskytnite AI agentovi rovnakých 17 nástrojov, aké máte vy.

požiadaviek za minútu

na token, nie na účet, s hlavičkou Retry-After pri každom stave 429, ktorá uvádza, koľko sekúnd čakať.

formáty súborov

push a pull vo formáte, ktorý vaše úložisko už používa. Množné čísla a zástupné symboly sa zachovajú v oboch smeroch. Pomenujte ho pomocou format= pri ktoromkoľvek volaní.

udalosti webhooku

celý katalóg, každý s príkladom payloadu v presnom tvare, aký nesie skutočné doručenie. GET /v1/webhooks/events.

nástroje MCP

ten istý projektový token, odovzdaný runtime agenta namiesto curl. npx -y @transglot/mcp.

Často kladené otázky

Čo sa vývojári pýtajú pred prvou požiadavkou.

Ako sa autentifikujem k Transglot API?

Pošlite bearer token: Authorization: Bearer $TRANSGLOT_TOKEN. Token patrí k jednému projektu, takže v ceste nie je žiadne ID projektu a ani žiadny kľúč pre celý účet, ktorý by mohol uniknúť. Tokeny vytvárate na stránke projektu a každý z nich má svoje vlastné oprávnenia: push, pull, manage, read, write.

Je API zadarmo?

Nie. Bearer token začína na pláne Starter za 19 USD mesačne. Bezplatná verzia pokrýva konzolu, čo stačí na to, aby ste zistili, či vám produkt vyhovuje, ale nemôže vytvoriť token. CLI, GitHub Action, webhooks, MCP a dodací balík sú všetky chránené tým istým tokenom, takže prichádzajú spolu.

Ako nahrám reťazce do Transglot?

POST /v1/push so súborom a jeho formátom, napríklad -F "file=@lang/en.json" -F "format=laravel_json". Odpovie stavom 202 a zaradí dávku do frontu. Prekladajú sa iba riadky, ktoré sa skutočne zmenili, takže odoslanie nezmeneného súboru nič nestojí.

Ako získam späť svoje preklady?

GET /v1/pull, v ktoromkoľvek z 20 formátov, kedykoľvek chcete. Je to koncový bod, ktorý obaľuje CLI, a ten, ktorý spúšťa API playground naživo. Nie je potrebné žiadať o export súboru a neexistuje žiadne časové okno, počas ktorého by prestali byť vaše údaje vašimi.

Aký je limit rýchlosti API?

60 požiadaviek za minútu, počítaných na token, nie na účet. Pri prekročení dostanete odpoveď 429 s hlavičkou Retry-After, ktorá uvádza, koľko sekúnd čakať, a nič sa neúčtuje ani sa nič nepíše čiastočne. Poskytnite CI a produkcii samostatné tokeny a hlučný build nemôže vyhladovať vašu aplikáciu.

Ktoré jazyky API podporuje?

Neexistuje pevný zoznam. Validátor prijíma akýkoľvek tag BCP-47, ktorý rozpoznáva ICU, čo je 708 lokalizácií v tabuľke, proti ktorej kontroluje, plus štrukturálna záložná možnosť pre tagy mimo nej. Pridajte lokalizáciu do projektu a nasledujúci push ju zahrnie.

Ktoré formáty súborov môžem odosielať a sťahovať?

Dvadsať: JSON plochý a vnorený, Laravel PHP a JSON, Android XML, iOS .strings, .stringsdict a .xcstrings, Flutter ARB, XLIFF 1.2 a 2.0, gettext .po, YAML, CSV, XLSX, Java properties, RESX, Markdown, Unity CSV a Unreal PO. Sedem z nich podporuje množné čísla a súbor sa vráti v tom istom tvare, v akom odišiel.

Má Transglot webhooks?

Áno. Existuje 12 udalostí webhooku, vrátane batch.completed, translation.reviewed, qa.completed a source_drift.repaired. Každé doručenie je podpísané HMAC s hlavičkou časovej pečiatky, takže si ho môžete overiť, a GET /v1/webhooks/events vráti katalóg s ukážkovou payload pre každú z nich.

Existuje MCP server pre AI agentov?

Áno. npx -y @transglot/mcp sprístupňuje 17 nástrojov prostredníctvom vášho projektového tokenu, takže asistent môže čítať preklad, písať ho, pridať jazyk, spustiť beh, skontrolovať dávku alebo upraviť glosár. Ide o rovnaké API a rovnaké oprávnenia, len sa k nim pristupuje z runtime agenta namiesto curl.

Môžem ho spustiť v CI?

Áno. GitHub Action (transglot/transglot-action@v1) aj CLI oba využívajú tieto koncové body. Keď je riadok zamietnutý, transglot push --wait skončí s kódom 4 a Action označí úlohu tohto behu ako neúspešnú. Ak chcete zastaviť zlúčenie, spustite ho na pull requestoch s nastaveným vstupom commit na none, pridajte krok, ktorý zlyhá, keď v stiahnutom súbore chýba kľúč, a nastavte túto úlohu ako povinnú kontrolu v ochrane vetvy.

Čo sa stane, keď preklad neprejde kontrolou kvality?

Štyri deterministické brány kontrolujú každý riadok: zástupné symboly, množné čísla, termíny z glosára a dĺžku. Porušený zástupný symbol, chýbajúca forma množného čísla alebo zakázaný termín z glosára spustí jednu automatickú nápravnú retry operáciu, a ak stále zlyhajú, riadok je zamietnutý namiesto zapísania. Riadok, ktorý iba presahuje svoju dĺžku, je zapísaný, nie zamietnutý. GET /v1/batches/:id?include=failures vypíše zamietnuté riadky a dôvody.

Poruší API niekedy moju integráciu?

Nie. /v1 iba pridáva koncové body a polia odpovede; pole, ktoré už parsujete, nemení tvar ani nezmizne. Zmena, ktorá by porušila kompatibilitu, by bola vydaná pod novým prefixom verzie, ktorý je rezervovaný a stále prázdny. Changelog API zaznamenáva každé vydanie.