added
O modelo de chave de implementação, onde o token portador É o projeto. É o que tanto a CLI como a Ação do GitHub executam.
api v1 · atual
O registo de alterações da API.
Nada removido.
A /v1 só adiciona funcionalidades. Novos endpoints e novos campos de resposta são introduzidos no mesmo prefixo, e um campo que já analisa nunca muda de forma ou desaparece. Uma alteração incompatível seria lançada sob um novo prefixo de versão, que está reservado e ainda vazio.
v1/api/v1
o único prefixo em uso
o único prefixo em uso
5 lançamentos
11 alterações, nenhuma delas incompatível
a estrutura do registo
Um prefixo de versão, sem remoções.
Três destas quatro são propriedades deste próprio registo. A quarta é o tamanho do catálogo de webhooks que a API serve.
5
lançamentos na /v1, todos eles aditivos
1
prefixo de versão em uso. O próximo está reservado e vazio
0
alterações incompatíveis desde o lançamento da API
12
eventos de webhook assinados. Fonte: App\Enums\WebhookEvent
datado por lançamento, não por semver
use as teclas de seta para navegar
2026-07-08
Entrega via CDN, utilização e o playground
July 8, 2026 · 4 alterações
05 / 05
added
/v1/incontext/translations, /screenshots e /suggest alimentam o editor visual, com CORS limitado a esse prefixo e nada mais.
POST /v1/incontext/session troca uma chave publicável e uma Origem por um token de sessão com escopo.
improved
Uma exportação bilingue agora reporta o que não conseguiu fazer round-trip em vez de substituir silenciosamente o texto de origem. Os campos existentes permanecem inalterados, que é exatamente o objetivo de colocá-lo num cabeçalho.
GET /v1/pull ganhou os cabeçalhos de resposta X-Skipped-Keys e X-Missing-Source-Keys.
added
Mais /v1/glossary/import, /export e /extract, para que uma base de termos possa ser movida para dentro e para fora sem abrir a consola.
CRUD completo da base de termos através da API: GET, POST, PUT e DELETE em /v1/glossary.
added
Os resultados aparecem nas linhas de tradução que já obtém, por isso não é necessário fazer novas consultas.
POST /v1/qa/run aciona uma verificação de qualidade agêntica e devolve o identificador da execução.
added
Subscreva por ponto final. A lista encontra-se em App\Enums\WebhookEvent, que atualmente contém doze casos; conte o enum em vez desta linha.
Os webhooks assinados emitem eventos de chave, tradução, idioma, glossário e QA juntamente com o par do lote original.
improved
A entrega inclui uma contagem e até vinte amostras, em vez de uma chamada por linha alterada. Os registos de entrega registam cada tentativa com a hora da próxima nova tentativa.
Os eventos de alta frequência, como translation.updated, são agrupados numa única entrega por janela, para que uma edição em massa nunca sobrecarregue um ponto final.
added
Devolve um ETag e uma cache de curta duração, e respeita If-None-Match com um 304. O irmão imutável em /v{n} tem endereçamento por conteúdo e fica em cache durante um ano.
Um GET público e armazenável em cache na edge, /v1/cdn/{project}/{locale}, serve as suas cadeias publicadas.
added
Acione-o no CI com POST /v1/cdn/publish e autorize leituras com uma chave dedicada de só leitura no cabeçalho X-Transglot-Cdn-Key. Seguro para colocar atrás de uma CDN própria.
A publicação promove as traduções atuais para uma nova versão imutável, manualmente ou em cada push.
added
Nenhum corpo de pedido é armazenado. É apenas uma contagem e nada mais.
Cada chamada /v1 autenticada é contabilizada por token por dia e apresentada no hub de implementação.
improved
Projeto, pull, lotes e exportação de glossário. Nenhuma forma de pedido ou resposta foi alterada para o fazer funcionar.
O hub de implementação ganhou um playground de API que executa pontos finais de só leitura em tempo real contra o seu projeto.
registo de descontinuação
Nada está a desaparecer.
Uma linha por superfície publicada, com a versão que a lançou. A última coluna é a que deve observar: uma remoção apareceria ali com uma data muito antes de ocorrer.
| Superfície | Lançado | Estado | Data de remoção |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | atual | nenhum agendado |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | atual | nenhum agendado |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | atual | nenhum agendado |
POST /v1/qa/run | June 12, 2026 | atual | nenhum agendado |
Signed webhook events, twelve typed cases | June 30, 2026 | atual | nenhum agendado |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | atual | nenhum agendado |
Uma linha nunca é eliminada desta tabela. Se uma superfície for descontinuada, mantém a sua linha e ganha uma data, pois o objetivo principal da publicação é poder planear a remoção.
a promessa de compatibilidade
Três regras em que pode construir.
aditivo
Novos endpoints e novos campos de resposta são lançados dentro de /v1. Um campo que já analisa não altera a sua estrutura nem desaparece.
novo prefixo
Uma alteração incompatível seria lançada sob um novo prefixo de versão em vez de dentro deste. Esse prefixo está reservado e não utilizado, e cada lançamento superior recaiu sobre v1.
cabeçalhos honestos
Quando uma solicitação não consegue processar algo em ciclo completo, indica-o num cabeçalho. X-Skipped-Keys e X-Missing-Source-Keys foram adicionados em vez de alterar o corpo da resposta.
Perguntas frequentes
O que os programadores perguntam sobre o controlo de versões e a descontinuação da API.
A API Transglot tem controlo de versões?
Sim, por prefixo de URL. Tudo o que foi publicado até agora está sob /v1, que é o único prefixo em uso. Não existe cabeçalho de versão, nem fixação por data, nem nada para configurar.
Uma atualização alguma vez irá quebrar a minha integração?
Não dentro de /v1. São adicionados novos endpoints e novos campos de resposta, mas um campo que já analisa não altera a sua estrutura nem desaparece. Se uma alteração não puder ser feita de forma aditiva, será colocada sob um novo prefixo e o antigo continuará a funcionar.
Alguma coisa foi descontinuada ou removida?
Nada, e o registo acima indica-o linha por linha. Cada superfície publicada está listada com a versão que a lançou e uma coluna de remoção que atualmente indica "nenhuma agendada" em todas as linhas.
Quanto aviso prévio seria dado para uma remoção?
Uma remoção apareceria nesse registo com uma data muito antes de ocorrer, e a linha permaneceria na tabela depois, em vez de desaparecer. Uma data contra a qual pode planear é o objetivo principal de publicar uma.
Como sei quando algo novo é lançado?
Cada lançamento tem uma data nesta página. O registo de alterações do produto abrange tudo o resto que é lançado e a consola mostra um marcador quando há algo que ainda não leu.
Porque existe um registo de alterações separado para a API?
Porque a API tem uma promessa de compatibilidade que um lançamento de produto não tem. Um programador que verifique se uma integração ainda funciona não deve ter de percorrer trabalho de funcionalidades para descobrir.
Como adiciono a API ao meu plano?
Um token bearer começa no plano Starter a 19 $ por mês. O plano gratuito cobre a consola, mas não permite gerar um token, e a CLI, a Ação do GitHub, os webhooks e o MCP estão todos protegidos por esse mesmo token.
Onde está a referência para os próprios endpoints?
Na página da API: autenticação, os endpoints, o limite de taxa, os formatos de ficheiro e o catálogo de webhooks. Esta página é apenas o registo do que mudou e quando.
funciona com o que já executa
41 conectores, já construídos.
o contrato é o produto
Construir sobre uma API que não se move.
A API está disponível nos planos Starter e superiores. O plano gratuito custa 0 $ e inclui 100.000 palavras para começar (25.000 no momento do registo, 75.000 após verificação telefónica), 10.000 por mês posteriormente, e não inclui acesso à API ou webhooks.