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

Sube un archivo. Recupera todos los idiomas.

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

en: 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.

Empieza gratis Ver la interfaz para desarrolladores

60 solicitudes por minuto por token · cada error 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 de la imagen de abajo tiene una ruta detrás: subida, validaciones, glosario, lotes y descarga, 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 primero una respuesta real.

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 lotes se actualiza automáticamente
GET/v1/batches/:id
Recuperas las traducciones
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 requiere una tarde entera

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

Marca la pull request como fallida cuando una traducción no pasa la validación.

cron · nocturno

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

bot · una suscripción

Publica en Slack apenas finalice un lote.

agente · mcp

Ofrece a un agente de IA las mismas 17 herramientas que tú tienes.

solicitudes por minuto

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

formatos de archivo

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

eventos de webhook

el catálogo completo, cada uno con un ejemplo de carga útil en 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 de portador: 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.

¿Es gratuita la API?

No. Un token de portador comienza en el plan Starter a 19 USD al mes. La versión gratuita cubre la consola, suficiente para ver si el producto se adapta 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 subir un archivo sin cambios no tiene costo.

¿Cómo recupero mis traducciones?

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 área de pruebas de la API. No hay solicitud de exportación a archivo 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 429 con un encabezado Retry-After indicando cuántos segundos esperar, y nada se cobrará ni quedará a medio escribir. Asigna tokens separados para CI y producción para que una compilación ruidosa no 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 son 708 configuraciones regionales en la tabla contra la que verifica, más un respaldo estructural para etiquetas fuera de ella. Añade una configuración regional al proyecto y la siguiente subida la incluirá.

¿Qué formatos de archivo puedo enviar y recibir?

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 Java, RESX, Markdown, Unity CSV y Unreal PO. Siete de ellos admiten plurales, y el archivo vuelve en la misma estructura con la que entró.

¿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 con 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.

¿Existe un servidor MCP para agentes de IA?

Sí. npx -y @transglot/mcp expone 17 herramientas a través del token de tu 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 finales. 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é ocurre cuando una traducción no supera 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 prohibido del glosario 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 máxima 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 endpoints y campos de respuesta; un campo que ya analizas no cambia de forma ni desaparece. Un cambio disruptivo 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.