api.transglot.ai/v1bärartoken, ett projektreferens

Skicka en fil. Få tillbaka varje språk.

Ett REST-API för översättning av din app. En POST laddar upp källfilen, en GET hämtar tillbaka en färdig locale och en bärartoken utgör hela autentiseringen. Allt som talar HTTP kan driva det.

in: ett anrop

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

300,000

ord per månad på Starter, den första planen som kan generera en token.

Börja gratis Se utvecklarverktygen

60 förfrågningar per minut och token · varje 429 innehåller en Retry-After · använd separata tokens för CI och produktion

konsolen är en API-klient

Pusha, översätt, granska och hämta, varje steg är en REST-slutpunkt.

Varje rad i bilden nedan har en rutt bakom sig: push, granskning, ordlista, batchar och pull, alla nåbara från din egen kod med en projekt-token. API-leksaken i konsolen kör de skrivskyddade live mot ditt projekt, så att du först ser ett riktigt svar.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Du laddar upp en källfil
POST/v1/push
Granskningspanelen fylls i
POST/v1/qa/run
Du låser en term
POST/v1/glossary
Batchvyn pollar sig själv
GET/v1/batches/:id
Du hämtar tillbaka översättningarna
GET/v1/pull

en rutt per panel, 60 per minut, funktioner per token · att få ut dina översättningar är också en slutpunkt

det är bara http

Fyra saker som team bygger först.

var och en är en enda slutpunkt och en projekt-token · ingen av dem tar en eftermiddag

merge-gate · en arbetsflödesfil

Gör pull requesten röd när en översättning misslyckas.

cron · varje natt

Översätt versionsanteckningarna över natten, varje natt.

bot · en prenumeration

Posta till Slack så fort en batch är klar.

agent · mcp

Ge en AI-agent samma 17 verktyg som du har.

förfrågningar per minut

per token, inte per konto, med en Retry-After-header på varje 429 som anger hur många sekunder man ska vänta.

filformat

pusha och hämta i det format ditt repository redan använder. Pluralformer och platshållare bevaras i båda riktningarna. Namnge det med format= i vilket anrop som helst.

webhook-händelser

hela katalogen, var och en med en exempelpayload i exakt den form en riktig leverans har. GET /v1/webhooks/events.

mcp-verktyg

samma projekttoken, skickad till en agentkörning istället för till curl. npx -y @transglot/mcp.

Vanliga frågor

Vad utvecklare undrar innan den första begäran.

Hur autentiserar jag mig mot Transglot API?

Skicka en bearer-token: Authorization: Bearer $TRANSGLOT_TOKEN. Token tillhör ett projekt, så det finns inget projekt-ID i sökvägen och ingen kontoglobal nyckel som kan läcka. Du skapar token på projektsidan och var och en har sina egna behörigheter: push, pull, hantera, läsa, skriva.

Är API:t gratis?

Nej. En bearer-token börjar på Starter-planen för 19 USD per månad. Gratisversionen täcker konsolen, vilket räcker för att se om produkten passar, men den kan inte skapa en token. CLI, GitHub Action, webhooks, MCP och leveranspaketet ligger alla bakom samma token, så de kommer tillsammans.

Hur laddar jag upp strängar till Transglot?

POST /v1/push med filen och dess format, till exempel -F "file=@lang/en.json" -F "format=laravel_json". Det svarar med 202 och köar en batch. Endast rader som faktiskt ändrats översätts, så att skicka en oförändrad fil kostar inget.

Hur hämtar jag mina översättningar?

GET /v1/pull, i valfritt av de 20 formaten, när du vill. Det är slutpunkten som CLI:n wrapper och den som API-playground kör live. Det finns ingen exportbegäran att arkivera och inget tidsfönster där data slutar vara din.

Vad är hastighetsbegränsningen för API:t?

60 begäranden per minut, räknat per token snarare än per konto. Om du överskrider gränsen får du 429 med en Retry-After-header som anger hur många sekunder du ska vänta, och inget debiteras eller skrivs halvfärdigt. Ge CI och produktion separata token så att en bullrig byggprocess inte svälter din app.

Vilka språk stöder API:t?

Det finns ingen fast lista. Validatorn accepterar alla BCP-47-taggar som ICU känner igen, vilket är 708 lokaler i tabellen den kontrollerar mot, plus ett strukturellt reservläge för taggar utanför den. Lägg till en lokal i projektet så inkluderas den vid nästa push.

Vilka filformat kan jag pusha och pulla?

Tjugo: JSON platt och nästlad, Laravel PHP och JSON, Android XML, iOS .strings, .stringsdict och .xcstrings, Flutter ARB, XLIFF 1.2 och 2.0, gettext .po, YAML, CSV, XLSX, Java properties, RESX, Markdown, Unity CSV och Unreal PO. Sju av dem hanterar pluralformer, och filen returneras i samma struktur som den skickades.

Har Transglot webhooks?

Ja. Det finns 12 webhook-händelser, inklusive batch.completed, translation.reviewed, qa.completed och source_drift.repaired. Varje leverans är HMAC-signerad med en tidsstämpelheader så att du kan verifiera den, och GET /v1/webhooks/events returnerar katalogen med ett exempelpayload för var och en.

Finns det en MCP-server för AI-agenter?

Ja. npx -y @transglot/mcp exponerar 17 verktyg via din projekt-token, så att en assistent kan läsa en översättning, skriva en, lägga till ett språk, starta en körning, kontrollera en batch eller redigera ordlistan. Det är samma API och samma behörigheter, nådda från en agent-runtime istället för från curl.

Kan jag köra det i CI?

Ja. GitHub Action (transglot/transglot-action@v1) och CLI:n kapslar båda in dessa slutpunkter. När en rad nekas avslutas transglot push --wait med kod 4 och Action misslyckas med jobbet för den körningen. För att stoppa en sammanslagning, kör den på pull requests med dess commit-input inställd på none, lägg till ett steg som misslyckas när en hämtad fil saknar en nyckel, och gör jobbet till en obligatorisk kontroll i grenskyddet.

Vad händer när en översättning misslyckas med en kvalitetskontroll?

Fyra deterministiska gatear läser varje rad: platshållare, pluraler, ordlistetermer och längd. En trasig platshållare, en saknad pluralform eller en förbjuden ordlisteterm får ett automatiskt korrigerande försök, och om det fortfarande misslyckas nekas raden istället för att skrivas. En rad som bara överskrider sin längd skrivs, inte nekas. GET /v1/batches/:id?include=failures listar de nekade raderna och varför.

Kommer API:t någonsin att bryta min integration?

Nej. /v1 får bara nya slutpunkter och svarsfält; ett fält du redan parsar ändrar inte form eller försvinner. En brytande ändring skulle släppas under ett nytt versionsprefix, som är reserverat och fortfarande tomt. API-changeloggen registrerar varje release.