api.transglot.ai/v1bearer token, één projectreferentie

Push een bestand. Ontvang elke taal terug.

Een REST API voor het vertalen van je app. Eén POST uploadt het bronbestand, één GET haalt een voltooide locale op en een bearer token is de volledige authenticatie. Alles dat HTTP spreekt, kan het aansturen.

in: één oproep

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

uit

300,000

woorden per maand op Starter, het eerste plan dat een token kan genereren.

Gratis starten Bekijk de developer-omgeving

60 verzoeken per minuut per token · elke 429 bevat een Retry-After · gebruik aparte tokens voor CI en productie

de console is een api-client

Pushen, vertalen, gates en pullen, elk een REST-endpoint.

Elke rij in de onderstaande afbeelding heeft een route erachter: pushen, gates, glossarium, batches en pullen, allemaal bereikbaar vanuit je eigen code met een projecttoken. De API-playground in de console voert de read-only endpoints live uit tegen je project, zodat je eerst een echt antwoord ziet.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Je uploadt een bronbestand
POST/v1/push
Het gate-paneel wordt ingevuld
POST/v1/qa/run
Je vergrendelt een term
POST/v1/glossary
De batchweergave peilt zichzelf
GET/v1/batches/:id
Je haalt de vertalingen terug
GET/v1/pull

één route per paneel, 60 per minuut, mogelijkheden per token · het exporteren van je vertalingen is ook een endpoint

het is gewoon http

Vier dingen die teams als eerste bouwen.

elk is één endpoint en een projecttoken · geen ervan kost een hele middag

merge gate · één workflow-bestand

Markeer de pull-request rood wanneer een vertaling faalt.

cron · elke nacht

Vertaal ’s nachts de release-opmerkingen, elke nacht opnieuw.

bot · één abonnement

Post naar Slack zodra een batch is voltooid.

agent · mcp

Geef een AI-agent dezelfde 17 tools als jij hebt.

verzoeken per minuut

per token, niet per account, met een Retry-After-header bij elke 429 die aangeeft hoeveel seconden je moet wachten.

bestandsindelingen

push en pull de indeling die je repository al gebruikt. Meervoudsvormen en placeholders blijven in beide richtingen behouden. Geef het op met format= bij elke aanroep.

webhook-events

de volledige catalogus, elk met een voorbeeldpayload in de exacte vorm van een echte levering. GET /v1/webhooks/events.

mcp-tools

hetzelfde projecttoken, gegeven aan een agent-runtime in plaats van aan curl. npx -y @transglot/mcp.

FAQ’s

Wat ontwikkelaars vragen vóór het eerste verzoek.

Hoe authenticeer ik mij bij de Transglot API?

Stuur een bearer-token: Authorization: Bearer $TRANSGLOT_TOKEN. Het token hoort bij één project, dus er staat geen project-id in het pad en er is geen accountbrede sleutel die kan lekken. Je maakt tokens aan op de projectpagina en elk token heeft zijn eigen mogelijkheden: push, pull, beheren, lezen, schrijven.

Is de API gratis?

Nee. Een bearer-token begint bij het Starter-abonnement voor $19 per maand. Het gratis plan dekt de console, wat voldoende is om te zien of het product past, maar hiermee kun je geen token aanmaken. De CLI, de GitHub Action, webhooks, MCP en het delivery-bundle zijn allemaal gekoppeld aan datzelfde token, dus ze komen samen beschikbaar.

Hoe upload ik strings naar Transglot?

POST /v1/push met het bestand en het formaat, bijvoorbeeld -F "file=@lang/en.json" -F "format=laravel_json". Het antwoordt met 202 en plaatst een batch in de wachtrij. Alleen rijen die daadwerkelijk zijn gewijzigd, worden vertaald, dus het pushen van een onveranderd bestand kost niets.

Hoe haal ik mijn vertalingen weer op?

GET /v1/pull, in elk van de 20 formaten, wanneer je wilt. Dit is het endpoint dat de CLI gebruikt en dat live draait in de API-playground. Er is geen exportverzoek nodig en er is geen periode waarin de data niet van jou is.

Wat is de API-rate limit?

60 verzoeken per minuut, geteld per token in plaats van per account. Daarboven krijg je een 429 met een Retry-After-header die aangeeft hoeveel seconden je moet wachten, en er wordt niets in rekening gebracht of half geschreven. Geef CI en productie aparte tokens, zodat een drukke build je app niet blokkeert.

Welke talen ondersteunt de API?

Er is geen vaste lijst. De validator accepteert elke BCP-47-tag die ICU herkent, wat neerkomt op 708 locales in de tabel waartegen wordt gecontroleerd, plus een structurele fallback voor tags daarbuiten. Voeg een locale toe aan het project en de volgende push neemt deze mee.

Welke bestandsformaten kan ik pushen en pullen?

Twintig: JSON plat en genest, Laravel PHP en JSON, Android XML, iOS .strings, .stringsdict en .xcstrings, Flutter ARB, XLIFF 1.2 en 2.0, gettext .po, YAML, CSV, XLSX, Java properties, RESX, Markdown, Unity CSV en Unreal PO. Zeven daarvan ondersteunen meervoudsvormen, en het bestand komt terug in dezelfde structuur als waarin het werd verzonden.

Heeft Transglot webhooks?

Ja. Er zijn 12 webhook-events, waaronder batch.completed, translation.reviewed, qa.completed en source_drift.repaired. Elke levering is HMAC-ondertekend met een timestamp-header zodat je deze kunt verifiëren, en GET /v1/webhooks/events retourneert de catalogus met een sample payload voor elk event.

Is er een MCP-server voor AI-agents?

Ja. npx -y @transglot/mcp biedt 17 tools via je projecttoken, zodat een assistent een vertaling kan lezen, schrijven, een taal kan toevoegen, een run kan starten, een batch kan controleren of de glossary kan bewerken. Het is dezelfde API en dezelfde machtigingen, maar dan benaderd vanuit een agent-runtime in plaats van via curl.

Kan ik het in CI draaien?

Ja. De GitHub Action (transglot/transglot-action@v1) en de CLI zijn beide wrappers voor deze eindpunten. Als een rij wordt geweigerd, sluit transglot push --wait af met exitcode 4 en faalt de taak van de Action voor die run. Om een merge te stoppen, voer je deze uit op pull requests met de commit-input ingesteld op none, voeg je een stap toe die faalt wanneer een opgehaald bestand een sleutel mist, en maak je de taak tot een vereiste check in de branchbeveiliging.

Wat gebeurt er als een vertaling faalt bij een quality check?

Vier deterministische gates controleren elke rij: placeholders, meervoudsvormen, glossary-termen en lengte. Een ongeldige placeholder, een ontbrekende meervoudsvorm of een verboden glossary-term krijgt één automatische correctieve retry; als het daarna nog steeds misgaat, wordt de rij geweigerd in plaats van geschreven. Een rij die alleen de lengte overschrijdt, wordt wel geschreven, niet geweigerd. GET /v1/batches/:id?include=failures toont de geweigerde rijen en de reden daarvoor.

Zal de API ooit mijn integratie breken?

Nee. /v1 krijgt alleen maar extra endpoints en response-velden; een veld dat je al parseert, verandert niet van structuur of verdwijnt niet. Een breaking change zou onder een nieuw versie-prefix worden uitgebracht, dat gereserveerd is en nog leeg. De API-changelog houdt elke release bij.