api.transglot.ai/v1bearer token, jeden projektreference

Nahrajte soubor. Získejte zpět každý jazyk.

REST API pro překlad vaší aplikace. Jedním POST požadavkem nahrajete zdrojový soubor, jedním GET získáte hotovou lokalizaci a bearer token představuje celou autentizaci. Může ho používat cokoli, co komunikuje přes HTTP.

v: jedno volání

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

ven

300,000

slov měsíčně na plánu Starter, první plán, který umožňuje vygenerovat token.

Začít zdarma Podívejte se na rozhraní pro vývojáře

60 požadavků za minutu na token · každá odpověď 429 obsahuje hlavičku Retry-After · pro CI a produkci používejte samostatné tokeny

konzole je klient API

Nahrát, přeložit, kontrolovat a stáhnout, každý krok jako REST endpoint.

Každý řádek na obrázku níže má svůj route: nahrávání, kontroly, glosář, batche a stahování, vše dostupné z vašeho kódu pomocí projektového tokenu. API playground v konzoli spouští read-only operace live proti vašemu projektu, takže nejprve uvidíte skutečnou odpověď.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Nahrajete zdrojový soubor
POST/v1/push
Panel kontrol se vyplní
POST/v1/qa/run
Uzamknete termín
POST/v1/glossary
Pohled na batch se sám aktualizuje
GET/v1/batches/:id
Stáhnete si překlady zpět
GET/v1/pull

jeden route na panel, 60 za minutu, oprávnění podle tokenu · získání překladů je také endpoint

je to jen HTTP

Čtyři věci, které týmy vytvářejí jako první.

každý z nich je jeden koncový bod a projektový token · žádný z nich nezabere celé odpoledne

merge gate · jeden soubor workflow

Zbarví pull request na červeně, když překlad selže.

cron · každou noc

Přeložte poznámky k vydání přes noc, každou noc.

bot · jedno předplatné

Odešle zprávu do Slacku ve chvíli, kdy dávka skončí.

agent · mcp

Dejte AI agentovi stejných 17 nástrojů, jaké máte vy.

požadavků za minutu

na token, ne na účet, s hlavičkou Retry-After u každého stavu 429, která říká, kolik sekund čekat.

formátů souborů

odesílejte a stahujte ve formátu, který vaše repository již používá. Množná čísla a zástupné symboly přežívají v obou směrech. Pojmenujte jej pomocí format= při volání.

událostí webhooku

celý katalog, každý s ukázkovou datovou částí v přesném tvaru, jaký nese skutečné doručení. GET /v1/webhooks/events.

nástrojů mcp

stejný projektový token, předaný běhovému prostředí agenta místo příkazu curl. npx -y @transglot/mcp.

Často kladené dotazy

Co se vývojáři ptají před prvním požadavkem.

Jak se autentizuji vůči API Transglot?

Pošlete bearer token: Authorization: Bearer $TRANSGLOT_TOKEN. Token patří k jednomu projektu, takže v cestě není žádné project id ani klíč pro celý účet, který by mohl uniknout. Tokiny vytvoříte na stránce projektu a každý z nich má své vlastní oprávnění: push, pull, manage, read, write.

Je API zdarma?

Ne. Bearer token začíná na plánu Starter za 19 USD měsíčně. Verze zdarma pokrývá konzoli, což stačí k ověření, zda produkt vyhovuje, ale nemůže vytvořit token. CLI, GitHub Action, webhooks, MCP a balíček pro doručování jsou všechny za tímto tokenem, takže přicházejí společně.

Jak nahraji řetězce do Transglot?

POST /v1/push se souborem a jeho formátem, například -F "file=@lang/en.json" -F "format=laravel_json". Odpoví stavem 202 a zařadí dávku. Překládají se pouze řádky, které se skutečně změnily, takže odeslání nezměněného souboru nic nestojí.

Jak získám své překlady zpět?

GET /v1/pull, v kterémkoli z 20 formátů, kdykoli chcete. Je to koncový bod, který obaluje CLI, a ten, který spouští API playground živě. Neexistuje žádný exportní požadavek k podání ani okno, ve kterém by data přestala být vaše.

Jaký je limit rychlosti API?

60 požadavků za minutu, počítáno na token, nikoliv na účet. Při překročení dostanete stav 429 s hlavičkou Retry-After, která říká, kolik sekund čekat, a nic se neúčtuje ani se nezapisuje částečně. Dejte CI a produkci samostatné tokeny a hlučný build nemůže vyhladovět vaši aplikaci.

Které jazyky API podporuje?

Neexistuje žádný pevný seznam. Validátor přijímá jakoukoli značku BCP-47, kterou rozpoznává ICU, což je 708 lokalizací v tabulce, proti které se kontroluje, plus strukturální záloha pro značky mimo ni. Přidejte lokalizaci do projektu a při dalším pushnutí bude zahrnuta.

Jaké formáty souborů mohu odesílat a stahovat?

Dvacet: JSON plochý a vnořený, 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. Sedm z nich nese množná čísla a soubor se vrátí ve stejném tvaru, v jakém byl odeslán.

Má Transglot webové hooky?

Ano. Existuje 12 událostí webhooku, včetně batch.completed, translation.reviewed, qa.completed a source_drift.repaired. Každé doručení je podepsáno HMAC s hlavičkou časového razítka, takže si jej můžete ověřit, a GET /v1/webhooks/events vrací katalog s ukázkovou datovou částí pro každou z nich.

Existuje server MCP pro AI agenty?

Ano. npx -y @transglot/mcp zpřístupňuje 17 nástrojů přes token vašeho projektu, takže asistent může číst překlad, psát jej, přidat jazyk, spustit běh, zkontrolovat dávku nebo upravit glosář. Jde o stejné API a stejná oprávnění, přístupná z runtime agenta místo z curl.

Mohu jej spustit v CI?

Ano. GitHub Action (transglot/transglot-action@v1) i CLI obalují tyto endpointy. Když je řádek zamítnut, transglot push --wait skončí s kódem 4 a Action označí úlohu v daném běhu jako neúspěšnou. Chcete-li zastavit sloučení, spusťte jej na pull requestech s nastavením commit input na none, přidejte krok, který selže, pokud v přijatém souboru chybí klíč, a nastavte úlohu jako povinnou kontrolu v ochraně větve.

Co se stane, když překlad neprojde kontrolou kvality?

Čtyři deterministické brány čtou každý řádek: zástupné symboly, množná čísla, termíny glosáře a délku. Porušený zástupný symbol, chybějící tvar množného čísla nebo zakázaný termín glosáře spustí jeden automatický nápravný pokus, a pokud stále selže, řádek je zamítnut místo zápisu. Řádek, který pouze překračuje svou délku, je zapsán, nikoliv zamítnut. GET /v1/batches/:id?include=failures vypíše zamítnuté řádky a důvody.

Rozbije API někdy mou integraci?

Ne. /v1 pouze získává endpointy a pole odpovědí; pole, která již parsujete, 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ý. Changelog API zaznamenává každé vydání.