added
El model de clau de desplegament, on el token portador ÉS el projecte. És el que utilitzen tant la CLI com l'acció de GitHub.
api v1 · actual
El registre de canvis de l'API.
Res eliminat.
/v1 només incorpora novetats. Nous punts d'entrada i nous camps de resposta s'afegeixen dins del mateix prefix, i un camp que ja analitzeu mai canvia d'estructura ni desapareix. Un canvi incompatible es publicaria sota un nou prefix de versió, que està reservat i encara buit.
v1/api/v1
l'únic prefix en ús
l'únic prefix en ús
5 versions
11 canvis, cap d'incompatible
l'estructura del registre
Un prefix de versió, sense eliminacions.
Tres d'aquests quatre són propietats d'aquest mateix registre. El quart és la mida del catàleg de webhooks que serveix l'API.
5
versions a /v1, totes additives
1
prefix de versió en ús. El següent està reservat i buit
0
canvis incompatibles des del llançament de l'API
12
esdeveniments de webhook signats. Font: App\Enums\WebhookEvent
datat per versió, no per semver
utilitza les fletxes del teclat per navegar
2026-07-08
Lliurament per CDN, ús i l'entorn de proves
July 8, 2026 · 4 canvis
05 / 05
added
/v1/incontext/translations, /screenshots i /suggest impulsen l'editor visual, amb CORS limitat a aquest prefix i res més.
POST /v1/incontext/session intercanvia una clau publicable i un Origin per un token de sessió amb àmbit definit.
improved
Una exportació bilingüe ara informa del que no ha pogut completar el cicle en lloc de substituir silenciosament el text d'origen. Els camps existents no canvien, que és precisament l'objectiu d'incloure-ho en una capçalera.
GET /v1/pull ha incorporat les capçaleres de resposta X-Skipped-Keys i X-Missing-Source-Keys.
added
A més, /v1/glossary/import, /export i /extract, de manera que una base de termes es pot moure dins i fora sense obrir la consola.
CRUD complet de la base de termes a través de l'API: GET, POST, PUT i DELETE a /v1/glossary.
added
Els resultats apareixen a les files de traducció que ja consulteu, de manera que no cal sondejar res de nou.
POST /v1/qa/run inicia una passada de qualitat agentiva i retorna l'identificador d'execució.
added
Subscriviu-vos per punt final. La llista es troba a App\Enums\WebhookEvent, que actualment conté dotze casos; compteu l'enumeració en lloc d'aquesta línia.
Els webhooks signats emeten esdeveniments de clau, traducció, idioma, glossari i QA juntament amb el parell de lot original.
improved
El lliurament inclou un recompte i fins a vint mostres, en lloc d'una crida per fila modificada. Els registres de lliurament enregistren cada intent amb l'hora del proper reintent.
Els esdeveniments d'alta freqüència, com translation.updated, s'agrupen en un sol lliurament per finestra, de manera que una edició massiva no satura mai un punt final.
added
Retorna un ETag i una memòria cau de curta durada, i respecta If-None-Match amb un 304. El germà immutable sota /v{n} té adreçament per contingut i es manté a la memòria cau durant un any.
Un GET públic i cachejable al perímetre, GET /v1/cdn/{project}/{locale}, serveix les vostres cadenes publicades.
added
Activeu-lo a la CI amb POST /v1/cdn/publish i autoritzeu les lectures amb una clau de només lectura dedicada a la capçalera X-Transglot-Cdn-Key. Segur de posar darrere d'una CDN pròpia.
La publicació promou les traduccions actuals a una nova versió immutable, manualment o a cada enviament.
added
No es desen cossos de sol·licitud. És només un recompte i res més.
Cada crida autenticada a /v1 es compta per token i dia, i es mostra al centre de desplegament.
improved
Projecte, extracció, lots i exportació de glossari. Cap forma de sol·licitud o resposta ha canviat per fer-ho funcionar.
El centre de desplegament ha incorporat un entorn de proves de l'API que executa punts finals de només lectura en directe contra el vostre projecte.
registre de descontinuacions
Res no està desapareixent.
Una fila per superfície publicada, amb la versió que la va llançar. L'última columna és la que cal vigilar: una eliminació hi apareixeria amb una data molt abans que es produís.
| Superfície | Publicat | Estat | Data de supressió |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | actual | cap programada |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | actual | cap programada |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | actual | cap programada |
POST /v1/qa/run | June 12, 2026 | actual | cap programada |
Signed webhook events, twelve typed cases | June 30, 2026 | actual | cap programada |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | actual | cap programada |
Cap fila no se suprimeix mai d'aquesta taula. Si una superfície es retira, manté la seva fila i afegeix una data, perquè el propòsit principal de publicar-la és poder planificar la supressió.
la promesa de compatibilitat
Tres regles sobre les quals pots construir.
additiu
Els nous punts d'extrem i els nous camps de resposta es publiquen dins de /v1. Un camp que ja analitzes no canvia d'estructura ni desapareix.
nou prefix
Un canvi trencador es publicaria sota un nou prefix de versió en lloc de dins d'aquest. Aquest prefix està reservat i sense ús, i cada llançament posterior s'ha situat a v1.
capçaleres honestes
Quan una sol·licitud no pot completar correctament alguna cosa, ho indica en una capçalera. S'han afegit X-Skipped-Keys i X-Missing-Source-Keys en lloc de modificar el cos de la resposta.
PMF
El que els desenvolupadors pregunten sobre el versionat i la retirada de l'API.
L'API de Transglot té versions?
Sí, mitjançant el prefix de la URL. Tot el publicat fins ara es troba sota /v1, que és l'únic prefix en ús. No hi ha cap capçalera de versió, ni fixació per data, ni res a configurar.
Una actualització podria trencar la meva integració?
No dins de /v1. S'afegeixen nous punts d'extrem i nous camps de resposta, però un camp que ja analitzeu no canvia d'estructura ni desapareix. Si un canvi no es pot fer de manera additiva, es publica sota un nou prefix i l'antic continua funcionant.
S'ha retirat o eliminat alguna cosa?
Res, i el registre anterior ho indica fila per fila. Cada superfície publicada es llista amb la versió que la va incloure i una columna de retirada que actualment indica "cap programada" fins al final.
Quin preavís es donaria per a una retirada?
Una retirada apareixeria en aquest registre amb una data molt abans que es produís, i la fila romandria a la taula després en lloc de desaparèixer. El propòsit principal de publicar-la és tenir una data contra la qual planificar.
Com sé quan es publica alguna cosa nova?
Cada versió està datada en aquesta pàgina. El registre de canvis del producte cobreix tota la resta de publicacions, i la consola mostra un marcador quan hi ha alguna cosa que encara no heu llegit.
Per què hi ha un registre de canvis separat per a l'API?
Perquè l'API inclou una promesa de compatibilitat que una versió del producte no ofereix. Un desenvolupador que comprovi si una integració segueix funcionant no hauria de haver de passar per les noves funcionalitats per esbrinar-ho.
Com afegeixo l'API al meu pla?
Un token bearer comença al pla Starter per 19 $ al mes. La versió gratuïta cobreix la consola però no permet generar un token, i la CLI, l'acció de GitHub, els webhooks i MCP requereixen aquest mateix token.
On es troba la referència dels propis endpoints?
A la pàgina de l’API: autenticació, els endpoints, el límit de freqüència, els formats de fitxer i el catàleg de webhooks. Aquesta pàgina només és el registre del que ha canviat i quan.
funciona amb el que ja utilitzes
41 connectors, ja integrats.
el contracte és el producte
Construeix sobre una API que no canvia.
L’API està disponible als plans Starter i superiors. El pla gratuït costa 0 $ i inclou 100.000 paraules per començar (25.000 en registrar-se, 75.000 després d’una verificació telefònica), 10.000 al mes posteriorment, i no inclou ni API ni webhooks.