api.transglot.ai/v1bearer-token, ett prosjektreferanse

Last opp en fil. Få tilbake alle språk.

Et REST-API for oversettelse av appen din. Én POST-lastning laster opp kildefilen, én GET-henting henter en ferdig locale, og et bearer-token er hele autentiseringen. Alt som snakker HTTP kan bruke det.

inn: én kall

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åned på Starter, det første abonnementet som kan generere et token.

Start gratis Se utviklergrensesnittet

60 forespørsler per minutt per token · hver 429-feil inneholder Retry-After · bruk separate tokens for CI og produksjon

konsollen er en API-klient

Last opp, oversett, kontroller og hent, hver enkelt er et REST-endepunkt.

Hver rad i bildet nedenfor har en rute bak seg: lasting, kontroller, ordliste, batcher og henting – alt tilgjengelig fra din egen kode med et prosjekt-token. API-lekeplassen i konsollen kjører de skrivebeskyttede operasjonene live mot prosjektet ditt, slik at du først ser et ekte svar.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Du laster opp en kildefil
POST/v1/push
Kontrollpanelet fylles ut
POST/v1/qa/run
Du låser et begrep
POST/v1/glossary
Batch-visningen poller seg selv
GET/v1/batches/:id
Du henter oversettelsene tilbake
GET/v1/pull

én rute per panel, 60 i minuttet, funksjoner per token · å sende ut oversettelsene dine er også et endepunkt

det er bare http

Fire ting team bygger først.

hver av dem er ett enkelt endepunkt og et prosjekt-token · ingen av dem tar en ettermiddag

merge-gate · én arbeidsflytfil

Gjør pull-forespørselen rød når en oversettelse feiler.

cron · hver natt

Oversett utgivelsesnotatene over natten, hver eneste natt.

bot · ett abonnement

Post til Slack så snart en batch er ferdig.

agent · mcp

Gi en AI-agent de samme 17 verktøyene som du har.

forespørsler i minuttet

per token, ikke per konto, med en Retry-After-header på hver 429 som sier hvor mange sekunder man må vente.

filformater

push og pull formatet repositoryet ditt allerede bruker. Flertall og plassholdere overlever begge veier. Navngi det med format= på ethvert kall.

webhook-hendelser

hele katalogen, hver med et eksempel på payload i nøyaktig den formen en reell levering har. GET /v1/webhooks/events.

mcp-verktøy

samme prosjekt-token, gitt til et agent-runtime i stedet for til curl. npx -y @transglot/mcp.

FAQ

Hva utviklere spør om før den første forespørselen.

Hvordan autentiserer jeg meg mot Transglot API?

Send et bearer-token: Authorization: Bearer $TRANSGLOT_TOKEN. Tokenet tilhører ett prosjekt, så det finnes ingen prosjekt-id i stien og ingen kontobred nøkkel som kan lekke. Du oppretter token på prosjektsiden, og hvert token har sine egne funksjoner: push, pull, administrere, lese, skrive.

Er API-et gratis?

Nei. Et bearer-token starter på Starter-planen til $19 i måneden. Gratis dekker konsollen, noe som er nok til å se om produktet passer, men det kan ikke opprette et token. CLI-en, GitHub Action, webhooks, MCP og leveringspakken ligger alle bak det samme tokenet, så de kommer sammen.

Hvordan laster jeg opp strenger til Transglot?

POST /v1/push med filen og dens format, for eksempel -F "file=@lang/en.json" -F "format=laravel_json". Det svarer 202 og setter en batch i kø. Bare radene som faktisk har endret seg blir oversatt, så å pushe en uendret fil koster ingenting.

Hvordan får jeg oversettelsene mine tilbake?

GET /v1/pull, i hvilket som helst av de 20 formatene, når du vil. Det er endepunktet CLI-en wrapper, og det API-lekeplassen kjører live. Det finnes ingen eksportforespørsel som skal arkiveres, og ingen vindu der dataene slutter å være dine.

Hva er API-ratebegrensningen?

60 forespørsler per minutt, telt per token snarere enn per konto. Overskrider du grensen, får du en 429-feil med en Retry-After-header som angir hvor mange sekunder du må vente, og ingenting blir belastet eller delvis skrevet. Bruk separate tokens for CI og produksjon, slik at en støyende byggprosess ikke sulter appen din.

Hvilke språk støtter API-en?

Det finnes ingen fast liste. Valideringen godtar enhver BCP-47-tag som ICU gjenkjenner, noe som utgjør 708 locale-koder i tabellen den sjekker mot, pluss et strukturelt fallback for tagger utenfor denne. Legg til en locale i prosjektet, så inkluderes den ved neste push.

Hvilke filformater kan jeg sende inn og hente ut?

Tyve: JSON (flat og nested), Laravel PHP og JSON, Android XML, iOS .strings, .stringsdict og .xcstrings, Flutter ARB, XLIFF 1.2 og 2.0, gettext .po, YAML, CSV, XLSX, Java properties, RESX, Markdown, Unity CSV og Unreal PO. Sju av dem støtter flertall, og filen returneres i samme format som den ble sendt inn.

Har Transglot webhooks?

Ja. Det finnes 12 webhook-hendelser, inkludert batch.completed, translation.reviewed, qa.completed og source_drift.repaired. Hver levering er HMAC-signert med en tidsstempel i headeren, slik at du kan verifisere den, og GET /v1/webhooks/events returnerer katalogen med et eksempel på payload for hver enkelt.

Finnes det en MCP-server for AI-agenter?

Ja. npx -y @transglot/mcp eksponerer 17 verktøy via prosjekttokenet ditt, slik at en assistent kan lese en oversettelse, skrive en, legge til et språk, starte en kjøring, sjekke en batch eller redigere ordlisten. Det er det samme API-et og de samme tillatelsene, nådd fra et agent-runtime i stedet for fra curl.

Kan jeg kjøre det i CI?

Ja. GitHub Action-en (transglot/transglot-action@v1) og CLI-en pakker begge disse endepunktene. Når en rad avvises, avsluttes transglot push --wait med kode 4, og handlingen mislykkes for den jobben under den kjøringen. For å stoppe en fletting, kjør den på pull requests med commit-inndata satt til none, legg til et steg som feiler når en hentet fil mangler en nøkkel, og gjør jobben til en obligatorisk sjekk i grenbeskyttelsen.

Hva skjer når en oversettelse feiler en kvalitetssjekk?

Fire deterministiske porter leser hver rad: plassholdere, flertall, ordlistetermer og lengde. En ødelagt plassholder, en manglende flertallsform eller en forbudt ordlisteterm får ett automatisk korrigerende forsøk, og hvis det fortsatt feiler, avvises raden i stedet for å skrives. En rad som bare overskrider lengdegrensen, skrives, ikke avvises. GET /v1/batches/:id?include=failures lister opp de avviste radene og hvorfor.

Vil API-en noen gang ødelegge integrasjonen min?

Nei. /v1 får kun nye endepunkter og responsfelter; et felt du allerede parser, endrer ikke struktur eller forsvinner. En brytende endring vil bli lansert under et nytt versjonsprefiks, som er reservert og fortsatt tomt. API-endringsloggen registrerer hver utgivelse.