added
El modelo de clave de despliegue, donde el token portador ES el proyecto. Es lo que ejecutan tanto la CLI como la Acción de GitHub.
api v1 · actual
El registro de cambios de la API.
Nada eliminado.
/v1 solo añade funcionalidades. Los nuevos endpoints y campos de respuesta se incorporan bajo el mismo prefijo, y un campo que ya analizas nunca cambia su estructura ni desaparece. Un cambio incompatible se lanzaría bajo un nuevo prefijo de versión, que está reservado y aún vacío.
v1/api/v1
el único prefijo en uso
el único prefijo en uso
5 versiones
11 cambios, ninguno de ellos incompatible
la estructura del registro
Un prefijo de versión, sin eliminaciones.
Tres de estos cuatro son propiedades del propio registro. El cuarto es el tamaño del catálogo de webhooks que sirve la API.
5
versiones en /v1, todas ellas aditivas
1
prefijo de versión en uso. El siguiente está reservado y vacío
0
cambios incompatibles desde el lanzamiento de la API
12
eventos de webhook firmados. Fuente: App\Enums\WebhookEvent
fechadas por versión, no por semver
usa las teclas de flecha para navegar
2026-07-08
Entrega CDN, uso y el entorno de pruebas
July 8, 2026 · 4 cambios
05 / 05
added
/v1/incontext/translations, /screenshots y /suggest impulsan el editor visual, con CORS limitado a ese prefijo y nada más.
POST /v1/incontext/session intercambia una clave publicable y un Origin por un token de sesión con ámbito.
improved
Una exportación bilingüe ahora informa de lo que no pudo completar el ciclo en lugar de sustituir silenciosamente el texto de origen. Los campos existentes no cambian, que es justo el objetivo de ponerlo en un encabezado.
GET /v1/pull ganó los encabezados de respuesta X-Skipped-Keys y X-Missing-Source-Keys.
added
Además de /v1/glossary/import, /export y /extract, para que una base de términos pueda importarse y exportarse sin abrir la consola.
CRUD completo de la base de términos a través de la API: GET, POST, PUT y DELETE en /v1/glossary.
added
Los hallazgos aparecen en las filas de traducción que ya obtienes, por lo que no es necesario sondear nada nuevo.
POST /v1/qa/run activa una pasada de calidad basada en agentes y devuelve el identificador de la ejecución.
added
Suscríbete por punto final. La lista reside en App\Enums\WebhookEvent, que actualmente contiene doce casos; cuenta el enum en lugar de esta línea.
Los webhooks firmados emiten eventos de clave, traducción, idioma, glosario y QA junto con el par de lotes original.
improved
La entrega incluye un recuento y hasta veinte muestras, en lugar de una llamada por cada fila modificada. Los registros de entrega registran cada intento con la hora del siguiente reintento.
Los eventos de alta frecuencia como translation.updated se agrupan en una sola entrega por ventana, evitando que una edición masiva sature un punto final.
added
Devuelve un ETag y una caché de corta duración, y respeta If-None-Match con un 304. El hermano inmutable bajo /v{n} está direccionado por contenido y se almacena en caché durante un año.
Un GET público y almacenable en caché perimetral en /v1/cdn/{project}/{locale} sirve tus cadenas publicadas.
added
Actívalo en CI con POST /v1/cdn/publish y autoriza las lecturas con una clave de solo lectura dedicada en el encabezado X-Transglot-Cdn-Key. Seguro para colocar detrás de tu propia CDN.
La publicación promociona las traducciones actuales a una nueva versión inmutable, manualmente o en cada push.
added
No se almacenan cuerpos de solicitud. Es solo un recuento y nada más.
Cada llamada autenticada a /v1 se cuenta por token al día y se muestra en el hub de despliegue.
improved
Proyecto, pull, lotes y exportación de glosario. No se cambió la forma de ninguna solicitud ni respuesta para hacerlo funcionar.
El hub de despliegue incorporó un entorno de pruebas de API que ejecuta puntos finales de solo lectura en vivo contra tu proyecto.
registro de obsolescencias
Nada está desapareciendo.
Una fila por superficie publicada, con la versión que la lanzó. La última columna es la que hay que vigilar: una eliminación aparecería allí con una fecha mucho antes de que ocurra.
| Superficie | Publicado | Estado | Fecha de eliminación |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | actual | ninguna programada |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | actual | ninguna programada |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | actual | ninguna programada |
POST /v1/qa/run | June 12, 2026 | actual | ninguna programada |
Signed webhook events, twelve typed cases | June 30, 2026 | actual | ninguna programada |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | actual | ninguna programada |
Una fila nunca se elimina de esta tabla. Si una superficie se retira, mantiene su fila y añade una fecha, porque poder planificar ante una eliminación es el objetivo principal de publicar una.
la promesa de compatibilidad
Tres reglas sobre las que puedes construir.
aditivo
Los nuevos endpoints y campos de respuesta se publican dentro de /v1. Un campo que ya analizas no cambia su estructura ni desaparece.
nuevo prefijo
Un cambio incompatible se publicaría bajo un nuevo prefijo de versión en lugar de dentro de este. Ese prefijo está reservado y sin usar, y cada lanzamiento posterior se ha realizado en v1.
encabezados honestos
Cuando una solicitud no puede devolver algo, lo indica en un encabezado. Se añadieron X-Skipped-Keys y X-Missing-Source-Keys en lugar de cambiar el cuerpo de la respuesta.
Preguntas frecuentes
Lo que los desarrolladores preguntan sobre el versionado y la obsolescencia de la API.
¿La API de Transglot tiene versiones?
Sí, por prefijo de URL. Todo lo publicado hasta ahora reside bajo /v1, que es el único prefijo en uso. No hay encabezado de versión, ni fijación por fecha, ni nada que configurar.
¿Una actualización podría romper mi integración?
No dentro de /v1. Se añaden nuevos endpoints y campos de respuesta, pero un campo que ya analizas no cambia su estructura ni desaparece. Si un cambio no pudiera hacerse de forma aditiva, se iría bajo un nuevo prefijo y el anterior seguiría funcionando.
¿Se ha depreciado o eliminado algo?
Nada, y el registro anterior lo indica fila por fila. Cada superficie publicada aparece con la versión que la lanzó y una columna de eliminación que actualmente indica "ninguna programada" hasta el final.
¿Cuánto aviso previo se daría para una eliminación?
Una eliminación aparecería en ese registro con una fecha mucho antes de que ocurriera, y la fila permanecería en la tabla después en lugar de desaparecer. El objetivo principal de publicar uno es tener una fecha contra la que planificar.
¿Cómo sé cuándo se lanza algo nuevo?
Cada lanzamiento tiene fecha en esta página. El registro de cambios del producto cubre todo lo demás que se lanza, y la consola muestra un marcador cuando hay algo que no has leído.
¿Por qué hay un registro de cambios separado para la API?
Porque la API conlleva una promesa de compatibilidad que un lanzamiento de producto no tiene. Un desarrollador que comprueba si una integración sigue funcionando no debería tener que desplazarse past trabajos de características para averiguarlo.
¿Cómo añado la API a mi plan?
Un token bearer comienza en el plan Starter a 19 $ al mes. La versión gratuita cubre la consola pero no permite generar un token, y la CLI, la acción de GitHub, los webhooks y MCP dependen todos de ese mismo token.
¿Dónde está la referencia de los propios endpoints?
En la página de la API: autenticación, endpoints, límite de tasa, formatos de archivo y catálogo de webhooks. Esta página es solo el registro de lo que cambió y cuándo.
Funciona con lo que ya utilizas
41 conectores, ya integrados.
el contrato es el producto
Construye sobre una API que no cambia.
La API está disponible en los planes Starter y superiores. El plan gratuito es de $0 con 100 000 palabras para empezar (25 000 al registrarse, 75 000 después de una verificación telefónica), 10 000 al mes después, y no incluye API ni webhooks.