api.transglot.ai/v1bearer-token, ét projektreference

Upload en fil. Få alle sprog tilbage.

En REST API til oversættelse af din app. Én POST uploader kildefilen, én GET henter en færdig lokalitet, og et bearer-token er hele autentificeringen. Alt, der taler HTTP, kan drive det.

ind: ét opkald

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 om måneden på Starter, den første plan, der kan oprette et token.

Start gratis Se udviklerfladen

60 anmodninger i minuttet per token · hver 429 indeholder en Retry-After · brug separate tokens til CI og produktion

konsollen er en api-klient

Push, oversæt, godkend og hent, hver enkelt en REST-endpoint.

Hver række i billedet nedenfor har en rute bag sig: push, gates, glosar, batches og pull, alt sammen tilgængeligt fra din egen kode med et projekt-token. API-playgrounden i konsollen kører de skrivebeskyttede live mod dit projekt, så du ser et rigtigt svar først.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Du uploader en kildefil
POST/v1/push
Panelet Gater udfyldes
POST/v1/qa/run
Du låser et begreb
POST/v1/glossary
Batchvisningen poller sig selv
GET/v1/batches/:id
Du henter oversættelserne tilbage
GET/v1/pull

én rute pr. panel, 60 i minuttet, funktioner pr. token · at få dine oversættelser ud er også et endpoint

det er bare http

Fire ting, som teams bygger først.

hver enkelt er et enkelt endpoint og et projekt-token · ingen af dem tager en eftermiddag

merge-gate · én workflow-fil

Gør pull-requesten rød, når en oversættelse fejler.

cron · hver nat

Oversæt release-noterne natten over, hver eneste nat.

bot · ét abonnement

Post til Slack, så snart en batch er færdig.

agent · mcp

Giv en AI-agent de samme 17 værktøjer, som du har.

forespørgsler i minuttet

pr. token, ikke pr. konto, med en Retry-After-header på hver 429, der angiver, hvor mange sekunder der skal ventes.

filformater

push og pull det format, dit repository allerede bruger. Flertal og pladsholdere bevares i begge retninger. Navngiv det med format= i ethvert kald.

webhook-hændelser

hele kataloget, hver med en eksempelpayload i den nøjagtige form, en rigtig levering har. GET /v1/webhooks/events.

mcp-værktøjer

det samme projekt-token, givet til en agent-runtime i stedet for til curl. npx -y @transglot/mcp.

FAQ

Hvad udviklere spørger om før den første forespørgsel.

Hvordan autentificerer jeg mig med Transglot API?

Send et bearer-token: Authorization: Bearer $TRANSGLOT_TOKEN. Tokenet tilhører ét projekt, så der er intet projekt-id i stien og ingen kontobred nøgle, der kan lække. Du opretter tokens på projektsiden, og hvert token har sine egne funktioner: push, pull, administrere, læse, skrive.

Er API'en gratis?

Nej. Et bearer-token starter på Starter-planen til $19 om måneden. Gratis dækker konsollen, hvilket er nok til at se, om produktet passer, men det kan ikke udstede et token. CLI'en, GitHub Action, webhooks, MCP og leveringsbundtet ligger alle bag det samme token, så de ankommer sammen.

Hvordan uploader jeg strenge til Transglot?

POST /v1/push med filen og dens format, f.eks. -F "file=@lang/en.json" -F "format=laravel_json". Det svarer med 202 og sætter en batch i kø. Kun rækker, der faktisk er ændret, oversættes, så det koster ingenting at uploade en uændret fil.

Hvordan henter jeg mine oversættelser tilbage?

GET /v1/pull, i et hvilket som helst af de 20 formater, når du vil. Det er endpointet, som CLI'en wrapper, og som API-playgrounden kører live. Der er ingen eksportanmodning, der skal indgives, og ingen periode, hvor dataene holder op med at være dine.

Hvad er API'ens hastighedsgrænse?

60 anmodninger i minuttet, talt pr. token snarere end pr. konto. Hvis du overskrider grænsen, får du en 429 med en Retry-After-header, der angiver, hvor mange sekunder du skal vente, og intet belastes eller skrives delvist. Giv CI og produktion separate tokens, så en støjende build ikke kan sulte din app.

Hvilke sprog understøtter API'en?

Der er ingen fast liste. Valideringen accepterer ethvert BCP-47-tag, som ICU genkender, hvilket er 708 lokaliteter i den tabel, den tjekker imod, plus et strukturelt fallback for tags uden for denne. Tilføj en lokalitet til projektet, og den næste upload inkluderer den.

Hvilke filformater kan jeg uploade og downloade?

Tyve: JSON fladt og indlejret, 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. Syv af dem indeholder flertalsformer, og filen returneres i samme struktur, som den blev sendt.

Har Transglot webhooks?

Ja. Der er 12 webhook-begivenheder, herunder batch.completed, translation.reviewed, qa.completed og source_drift.repaired. Hver levering er HMAC-signeret med en tidsstempel-header, så du kan verificere den, og GET /v1/webhooks/events returnerer kataloget med et eksempel-payload for hver begivenhed.

Er der en MCP-server til AI-agenter?

Ja. npx -y @transglot/mcp eksponerer 17 værktøjer via dit projekt-token, så en assistent kan læse en oversættelse, skrive en, tilføje et sprog, starte en kørsel, tjekke en batch eller redigere glosariet. Det er den samme API og de samme tilladelser, blot tilgået fra en agent-runtime i stedet for fra curl.

Kan jeg køre det i CI?

Ja. Både GitHub Action (transglot/transglot-action@v1) og CLI’en wrapper disse endpoints. Når en række afvises, afslutter transglot push --wait med kode 4, og Action’en fejler jobbet for den pågældende kørsel. For at stoppe en merge skal du køre den på pull requests med commit-input sat til none, tilføje et trin, der fejler, når en hentet fil mangler en nøgle, og gøre jobbet til et obligatorisk check i grenbeskyttelsen.

Hvad sker der, når en oversættelse fejler en kvalitetskontrol?

Fire deterministiske gates læser hver række: pladsholdere, flertal, glossar-termer og længde. En ødelagt pladsholder, en manglende flertalsform eller en forbudt glossar-term udløser ét automatisk korrigerende forsøg, og hvis det stadig fejler, afvises rækken i stedet for at blive skrevet. En række, der kun overskrider sin længdegrænse, skrives og afvises ikke. GET /v1/batches/:id?include=failures lister de afviste rækker og årsagen.

Vil API'en nogensinde ødelægge min integration?

Nej. /v1 får kun nye endpoints og responsfelter; et felt, du allerede parser, ændrer ikke struktur eller forsvinder. En brydende ændring ville blive udgivet under et nyt versionspræfiks, som er reserveret og stadig tomt. API-changelogen registrerer hver udgivelse.