api.transglot.ai/v1token de portador, un proyectoreferencia

Sube un archivo. Recibe todos los idiomas de vuelta.

Una API REST para traducir tu aplicación. Un POST sube el archivo de origen, un GET devuelve una configuración regional terminada y un token de portador es toda la autenticación necesaria. Cualquier cosa que hable HTTP puede utilizarla.

entrada: una llamada

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

salida

300,000

palabras al mes en Starter, el primer plan que puede generar un token.

Comenzar gratis Ver la interfaz para desarrolladores

60 solicitudes por minuto por token · cada 429 incluye un Retry-After · usa tokens separados para CI y producción

la consola es un cliente de API

Sube, traduce, valida y descarga, cada uno es un endpoint REST.

Cada fila en la imagen de abajo tiene una ruta detrás: subir, validaciones, glosario, lotes y descargar, todo accesible desde tu propio código con un token de proyecto. El entorno de pruebas de la API en la consola ejecuta las operaciones de solo lectura en vivo contra tu proyecto, para que veas una respuesta real primero.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Subes un archivo de origen
POST/v1/push
El panel de validaciones se completa
POST/v1/qa/run
Bloqueas un término
POST/v1/glossary
La vista de lote se sondea a sí misma
GET/v1/batches/:id
Recibes las traducciones de vuelta
GET/v1/pull

una ruta por panel, 60 por minuto, capacidades por token · obtener tus traducciones también es un endpoint

es solo HTTP

Cuatro cosas que los equipos construyen primero.

cada uno es un único endpoint y un token de proyecto · ninguno toma una tarde

puerta de enlace de fusión · un archivo de flujo de trabajo

Pon en rojo la pull request cuando falle una traducción.

cron · cada noche

Traduce las notas de la versión durante la noche, todas las noches.

bot · una suscripción

Publica en Slack en el momento en que termina un lote.

agente · MCP

Proporciona a un agente de IA las mismas 17 herramientas que tienes.

solicitudes por minuto

por token, no por cuenta, con un encabezado Retry-After en cada 429 indicando cuántos segundos esperar.

formatos de archivo

envía y recibe en el formato que ya usa tu repositorio. Los plurales y marcadores se conservan en ambas direcciones. Nómbralo con format= en cualquiera de las llamadas.

eventos de webhook

todo el catálogo, cada uno con un ejemplo de carga útil con la estructura exacta de una entrega real. GET /v1/webhooks/events.

herramientas MCP

el mismo token de proyecto, entregado a un entorno de ejecución de agente en lugar de a curl. npx -y @transglot/mcp.

Preguntas frecuentes

Lo que preguntan los desarrolladores antes de la primera solicitud.

¿Cómo me autentico con la API de Transglot?

Envía un token bearer: Authorization: Bearer $TRANSGLOT_TOKEN. El token pertenece a un proyecto, por lo que no hay id de proyecto en la ruta ni clave a nivel de cuenta que pueda filtrarse. Creas tokens en la página del proyecto y cada uno tiene sus propias capacidades: push, pull, manage, read, write.

¿La API es gratuita?

No. Un token bearer comienza en el plan Starter a $19 al mes. La versión gratuita cubre la consola, lo cual es suficiente para ver si el producto se ajusta a tus necesidades, pero no permite generar un token. La CLI, la acción de GitHub, los webhooks, MCP y el paquete de entrega funcionan con ese mismo token, por lo que llegan juntos.

¿Cómo subo cadenas a Transglot?

POST /v1/push con el archivo y su formato, por ejemplo -F "file=@lang/en.json" -F "format=laravel_json". Responde con 202 y pone en cola un lote. Solo se traducen las filas que realmente cambiaron, por lo que enviar un archivo sin cambios no tiene costo.

¿Cómo obtengo mis traducciones de vuelta?

GET /v1/pull, en cualquiera de los 20 formatos, cuando lo desees. Es el endpoint que envuelve la CLI y el que ejecuta en vivo el playground de la API. No hay solicitud de exportación que archivar ni ventana en la que los datos dejen de ser tuyos.

¿Cuál es el límite de tasa de la API?

60 solicitudes por minuto, contadas por token en lugar de por cuenta. Si lo superas, recibirás un error 429 con un encabezado Retry-After que indica cuántos segundos esperar, y no se cobrará nada ni se escribirán datos parcialmente. Asigna tokens separados para CI y producción para evitar que una compilación problemática afecte a tu aplicación.

¿Qué idiomas admite la API?

No hay una lista fija. El validador acepta cualquier etiqueta BCP-47 que ICU reconozca, lo que abarca 708 configuraciones regionales en la tabla de verificación, además de un respaldo estructural para etiquetas fuera de ella. Agrega una configuración regional al proyecto y la próxima sincronización la incluirá.

¿Qué formatos de archivo puedo enviar y descargar?

Veinte: JSON plano y anidado, Laravel PHP y JSON, Android XML, iOS .strings, .stringsdict y .xcstrings, Flutter ARB, XLIFF 1.2 y 2.0, gettext .po, YAML, CSV, XLSX, propiedades de Java, RESX, Markdown, Unity CSV y Unreal PO. Siete de ellos admiten plurales, y el archivo se devuelve con la misma estructura con la que se envió.

¿Transglot tiene webhooks?

Sí. Hay 12 eventos de webhook, incluidos batch.completed, translation.reviewed, qa.completed y source_drift.repaired. Cada entrega está firmada con HMAC y lleva un encabezado de marca de tiempo para que puedas verificarla, y GET /v1/webhooks/events devuelve el catálogo con una carga útil de ejemplo para cada uno.

¿Hay un servidor MCP para agentes de IA?

Sí. npx -y @transglot/mcp expone 17 herramientas mediante tu token de proyecto, por lo que un asistente puede leer una traducción, escribir una, añadir un idioma, iniciar una ejecución, comprobar un lote o editar el glosario. Es la misma API y los mismos permisos, accesibles desde un entorno de ejecución de agente en lugar de desde curl.

¿Puedo ejecutarlo en CI?

Sí. La acción de GitHub (transglot/transglot-action@v1) y la CLI envuelven estos puntos de conexión. Cuando se rechaza una fila, transglot push --wait sale con el código 4 y la acción hace fallar su trabajo en esa ejecución. Para detener una fusión, ejecútala en solicitudes de extracción con su entrada de commit establecida en none, añade un paso que falle cuando falte una clave en un archivo extraído y configura el trabajo como una comprobación obligatoria en la protección de ramas.

¿Qué sucede cuando una traducción falla una comprobación de calidad?

Cuatro puertas de enlace deterministas leen cada fila: marcadores de posición, plurales, términos del glosario y longitud. Un marcador de posición incorrecto, una forma plural faltante o un término de glosario prohibido reciben un reintento correctivo automático y, si sigue fallando, la fila se rechaza en lugar de escribirse. Una fila que solo supera su longitud se escribe, no se rechaza. GET /v1/batches/:id?include=failures enumera las filas rechazadas y el motivo.

¿La API romperá alguna vez mi integración?

No. /v1 solo añade puntos finales y campos de respuesta; un campo que ya analizas no cambia su estructura ni desaparece. Un cambio importante se lanzaría bajo un nuevo prefijo de versión, que está reservado y aún vacío. El registro de cambios de la API registra cada lanzamiento.