added
El modelo de clave de despliegue, donde el token portador ES el proyecto. Es lo que utilizan 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 de formato ni desaparece. Un cambio incompatible se publicarí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
fechados por versión, no por semver
usa las teclas de flecha para navegar
2026-07-08
Entrega mediante 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 alcance limitado.
improved
Una exportación bilingüe ahora informa de lo que no pudo convertir completamente en lugar de sustituir silenciosamente el texto de origen. Los campos existentes permanecen sin cambios, que es precisamente el objetivo de incluirlo en un encabezado.
GET /v1/pull obtuvo 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 moverse dentro y fuera 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 consultas, por lo que no es necesario sondear nada nuevo.
POST /v1/qa/run activa un control de calidad basado en agentes y devuelve el identificador de la ejecución.
added
Suscríbete por punto de conexión. 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 control de calidad junto con el par original del lote.
improved
La entrega incluye un recuento y hasta veinte muestras en lugar de una llamada por 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, así que una edición masiva nunca satura un punto de conexión.
added
Devuelve un ETag y una caché de corta duración, y respeta If-None-Match con un 304. El recurso 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, /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. Es seguro colocarlo 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 centro de implementación.
improved
Proyecto, pull, lotes y exportación de glosario. No se modificó ninguna forma de solicitud ni respuesta para hacerlo funcionar.
El centro de implementación incorporó un entorno de pruebas de API que ejecuta puntos de conexión 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 debes vigilar: una eliminación aparecería allí con una fecha mucho antes de que ocurriera.
| Superficie | Lanzado | Estado | Fecha de eliminación |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | actual | ninguno programado |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | actual | ninguno programado |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | actual | ninguno programado |
POST /v1/qa/run | June 12, 2026 | actual | ninguno programado |
Signed webhook events, twelve typed cases | June 30, 2026 | actual | ninguno programado |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | actual | ninguno programado |
Nunca se elimina una fila de esta tabla. Si se retira una superficie, mantiene su fila y se le asigna una fecha, ya que el objetivo principal de publicarla es poder planificar su eliminación.
la promesa de compatibilidad
Tres reglas sobre las que puedes construir.
aditivo
Los nuevos puntos finales y los nuevos campos de respuesta se lanzan dentro de /v1. Un campo que ya analizas no cambia de forma ni desaparece.
nuevo prefijo
Un cambio incompatible se lanzaría bajo un nuevo prefijo de versión en lugar de dentro de este. Ese prefijo está reservado y sin usar, y cada lanzamiento superior se ha realizado en v1.
encabezados honestos
Cuando una solicitud no puede procesar algo completamente, lo indica en un encabezado. Se agregaron X-Skipped-Keys y X-Missing-Source-Keys en lugar de cambiar el cuerpo subyacente.
Preguntas frecuentes
Lo que los desarrolladores preguntan sobre el control de versiones y la eliminación gradual de la API.
¿La API de Transglot tiene control de versiones?
Sí, por prefijo de URL. Todo lo publicado hasta ahora se encuentra 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 agregan nuevos extremos y nuevos campos de respuesta, pero un campo que ya analizas no cambia su estructura ni desaparece. Si algún cambio no puede hacerse de forma aditiva, se publica bajo un nuevo prefijo y el anterior sigue funcionando.
¿Se ha eliminado o descontinuado 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" en todas las filas.
¿Con cuánta antelación se avisaría sobre una eliminación?
Una eliminación aparecería en ese registro con una fecha mucho antes de que ocurra, y la fila permanecería en la tabla después en lugar de desaparecer. Poder planificar con base en una fecha es precisamente el objetivo de publicarla.
¿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 indicador cuando hay algo que aún 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 del producto no ofrece. Un desarrollador que verifica si una integración sigue funcionando no debería tener que desplazarse entre novedades de funciones para averiguarlo.
¿Cómo agrego la API a mi plan?
Un token de portador comienza en el plan Starter a $19 al mes. La versión gratuita cubre la consola, pero no permite generar un token; la CLI, la acción de GitHub, los webhooks y MCP requieren ese mismo token.
¿Dónde está la referencia de los propios endpoints?
En la página de la API: autenticación, los endpoints, el límite de tasa, los formatos de archivo y el 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 Starter y superiores. Gratis es $0 con 100,000 palabras para comenzar (25,000 al registrarse, 75,000 después de una verificación telefónica), 10,000 al mes después, y sin API ni webhooks.