api.transglot.ai/v1token bearer, un projectereferència

Puja un fitxer. Obté cada idioma de tornada.

Una API REST per traduir la teva aplicació. Un POST puja el fitxer d'origen, un GET retorna una configuració regional acabada i un token bearer constitueix tota l'autenticació. Qualsevol cosa que parli HTTP pot utilitzar-la.

en: una crida

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

sortida

300,000

paraules al mes al pla Starter, el primer pla que permet generar un token.

Comença gratis Consulta la interfície per a desenvolupadors

60 sol·licituds per minut per token · cada error 429 inclou Retry-After · utilitza tokens separats per a CI i producció

la consola és un client API

Puja, tradueix, valida i recupera, cadascun és un endpoint REST.

Cada fila de la imatge inferior té una ruta associada: pujada, validacions, glossari, lots i recuperació, totes accessibles des del teu propi codi amb un token de projecte. L'àrea de proves de l'API a la consola executa les operacions de només lectura en temps real contra el teu projecte, així veuràs una resposta real primer.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Puges un fitxer d'origen
POST/v1/push
El panell de validacions s'omple
POST/v1/qa/run
Bloqueges un terme
POST/v1/glossary
La vista de lots es sondeja automàticament
GET/v1/batches/:id
Recuperes les traduccions
GET/v1/pull

una ruta per panell, 60 per minut, habilitats per token · obtenir les teves traduccions també és un punt final

només és HTTP

Quatre coses que els equips construeixen primer.

cadascun és un únic punt final i un token de projecte · cap d’ells requereix una tarda sencera

porta de fusió · un sol fitxer de flux de treball

Marca la sol·licitud d’integració en vermell quan falli una traducció.

cron · cada nit

Tradueix les notes de la versió durant la nit, cada nit.

bot · una subscripció

Publica a Slack tan bon punt acabi un lot.

agent · MCP

Doneu a un agent d'IA les mateixes 17 eines que teniu vosaltres.

sol·licituds per minut

per token, no per compte, amb una capçalera Retry-After a cada 429 que indica quants segons cal esperar.

formats de fitxer

envia i rep el format que ja utilitza el teu repositori. Els plurals i els marcadors es conserven en ambdós sentits. Especifica-ho amb format= en qualsevol crida.

esdeveniments de webhook

tot el catàleg, cadascun amb una càrrega útil d’exemple amb l’estructura exacta d’un lliurament real. GET /v1/webhooks/events.

eines MCP

el mateix token de projecte, lliurat a un temps d’execució d’agent en lloc de a curl. npx -y @transglot/mcp.

PMF

El que pregunten els desenvolupadors abans de la primera sol·licitud.

Com m’autentico amb l’API de Transglot?

Envia un token bearer: Authorization: Bearer $TRANSGLOT_TOKEN. El token pertany a un projecte, de manera que no hi ha cap id de projecte al camí ni cap clau de compte que pugui filtrar-se. Pots crear tokens a la pàgina del projecte i cadascun té les seves pròpies habilitats: push, pull, manage, read, write.

L’API és gratuïta?

No. Un token bearer comença al pla Starter a 19 $ al mes. La versió gratuïta cobreix la consola, que és suficient per veure si el producte s’ajusta a les teves necessitats, però no permet generar un token. La CLI, l’acció de GitHub, els webhooks, MCP i el paquet de lliurament depenen tots d’aquest mateix token, de manera que arriben junts.

Com pujo cadenes a Transglot?

POST /v1/push amb el fitxer i el seu format, per exemple -F "file=@lang/en.json" -F "format=laravel_json". Respon amb 202 i posa en cua un lot. Només es tradueixen les files que han canviat realment, de manera que pujar un fitxer sense canvis no té cap cost.

Com recupero les meves traduccions?

GET /v1/pull, en qualsevol dels 20 formats, quan vulguis. És el punt final que embolcalla la CLI i el que executa en directe l’entorn de proves de l’API. No cal sol·licitar una exportació ni hi ha cap finestra temporal en què les dades deixen de ser teves.

Quin és el límit de freqüència de l'API?

60 sol·licituds per minut, comptades per token i no per compte. Si el superes, rebràs un error 429 amb una capçalera Retry-After que indica quants segons has d'esperar, i no es carregarà res ni es deixaran dades a mig escriure. Utilitza tokens separats per a CI i producció perquè una compilació sorollosa no afecti la teva aplicació.

Quins idiomes admet l'API?

No hi ha una llista fixa. El validador accepta qualsevol etiqueta BCP-47 reconeguda per ICU, que correspon a 708 configuracions regionals de la taula que consulta, més una reserva estructural per a etiquetes fora d'aquesta. Afegeix una configuració regional al projecte i la propera càrrega la inclourà.

Quins formats de fitxer puc enviar i rebre?

Vint: JSON pla i niuat, Laravel PHP i JSON, Android XML, iOS .strings, .stringsdict i .xcstrings, Flutter ARB, XLIFF 1.2 i 2.0, gettext .po, YAML, CSV, XLSX, propietats Java, RESX, Markdown, Unity CSV i Unreal PO. Set d'ells admeten plurals, i el fitxer es retorna amb la mateixa estructura amb què s'ha enviat.

Transglot té webhooks?

Sí. Hi ha 12 esdeveniments de webhook, incloent-hi batch.completed, translation.reviewed, qa.completed i source_drift.repaired. Cada lliurament està signat amb HMAC amb una capçalera de marca de temps perquè puguis verificar-lo, i GET /v1/webhooks/events retorna el catàleg amb una càrrega útil d'exemple per a cadascun.

Hi ha un servidor MCP per a agents d'IA?

Sí. npx -y @transglot/mcp exposa 17 eines mitjançant el vostre token de projecte, de manera que un assistent pot llegir una traducció, escriure'n una, afegir un idioma, iniciar una execució, comprovar un lot o editar el glossari. És la mateixa API i els mateixos permisos, accessibles des d'un entorn d'execució d'agent en lloc de fer-ho amb curl.

Puc executar-ho en CI?

Sí. L'acció de GitHub (transglot/transglot-action@v1) i la CLI encapsulen aquests punts finals. Quan es rebutja una fila, transglot push --wait surt amb el codi 4 i l'acció fa fallar la tasca d'aquesta execució. Per aturar una fusió, executeu-la en sol·licituds d'extracció amb la seva entrada de confirmació definida com a cap, afegiu un pas que falli quan falti una clau en un fitxer extret i feu que la tasca sigui una comprovació obligatòria a la protecció de branques.

Què passa quan una traducció no supera un control de qualitat?

Quatre portes deterministes llegeixen cada fila: marcadors, plurals, termes del glossari i longitud. Un marcador trencat, una forma plural que falta o un terme de glossari prohibit provoca un reintenta correctiu automàtic i, si continua fallant, la fila es rebutja en lloc d'escriure's. Una fila que només supera la seva longitud s'escriu, no es rebutja. GET /v1/batches/:id?include=failures enumera les files rebutjades i el motiu.

L'API trencarà mai la meva integració?

No. /v1 només afegeix punts finals i camps de resposta; un camp que ja analitzes no canvia d'estructura ni desapareix. Un canvi incompatible es publicaria sota un nou prefix de versió, que està reservat i encara buit. El registre de canvis de l'API documenta cada llançament.