added
O modelo de chave de deploy, onde o token bearer É o projeto. É nele que a CLI e a Ação do GitHub funcionam.
api v1 · atual
O changelog da API.
Nada removido.
/v1 apenas adiciona recursos. Novos endpoints e novos campos de resposta chegam sob o mesmo prefixo, e um campo que você já processa nunca muda de forma ou desaparece. Uma mudança 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 versões
11 alterações, nenhuma delas incompatível
a estrutura do log
Um prefixo de versão, sem remoções.
Três destes quatro são propriedades deste log em si. O quarto é o tamanho do catálogo de webhooks que a API serve.
5
lançamentos no /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, uso e playground
July 8, 2026 · 4 alterações
05 / 05
added
/v1/incontext/translations, /screenshots e /suggest alimentam o editor visual, com CORS restrito 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 bilíngue agora relata o que não pôde ser feito round-trip em vez de substituir silenciosamente o texto de origem. Os campos existentes permanecem inalterados, que é exatamente o objetivo de colocá-lo em um cabeçalho.
GET /v1/pull ganhou os cabeçalhos de resposta X-Skipped-Keys e X-Missing-Source-Keys.
added
Além de /v1/glossary/import, /export e /extract, permitindo que a base de termos seja movida para dentro e para fora sem abrir o console.
CRUD completo da base de termos via API: GET, POST, PUT e DELETE em /v1/glossary.
added
As descobertas aparecem nas linhas de tradução que você já busca, então não é necessário consultar nada novo.
POST /v1/qa/run aciona uma passagem de qualidade baseada em agentes e retorna o identificador da execução.
added
Inscreva-se por endpoint. A lista reside em App\Enums\WebhookEvent, que possui doze casos atualmente; conte o enum em vez desta linha.
Webhooks assinados emitem eventos de chave, tradução, idioma, glossário e QA junto com o par de lote original.
improved
A entrega carrega uma contagem e até vinte amostras, em vez de uma chamada por linha alterada. Os registros de entrega registram cada tentativa com a hora da próxima nova tentativa.
Eventos de alta frequência como translation.updated são agrupados em uma única entrega por janela, evitando sobrecarga no endpoint durante edições em massa.
added
Retorna um ETag e um cache de curta duração, respeitando If-None-Match com um 304. O irmão imutável em /v{n} é endereçado por conteúdo e armazenado em cache por um ano.
Um GET público e cacheável na borda, /v1/cdn/{project}/{locale}, serve suas strings publicadas.
added
Acione no CI com POST /v1/cdn/publish e autorize leituras com uma chave dedicada somente leitura no cabeçalho X-Transglot-Cdn-Key. Seguro para colocar atrás de sua própria CDN.
A publicação promove as traduções atuais para uma nova versão imutável, manualmente ou a cada push.
added
Nenhum corpo de solicitação é armazenado. É apenas uma contagem, nada mais.
Cada chamada autenticada /v1 é contabilizada por token por dia e exibida no hub de implantação.
improved
Projeto, pull, lotes e exportação de glossário. Nenhuma forma de solicitação ou resposta foi alterada para fazer isso funcionar.
O hub de implantação ganhou um playground de API que executa endpoints somente leitura ao vivo contra seu projeto.
registro de descontinuação
Nada está sendo removido.
Uma linha por superfície publicada, com a versão que a lançou. A última coluna é a que deve ser observada: uma remoção apareceria ali com uma data muito antes de ocorrer.
| Superfície | Lançada | Status | Data de remoção |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | atual | nenhuma agendada |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | atual | nenhuma agendada |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | atual | nenhuma agendada |
POST /v1/qa/run | June 12, 2026 | atual | nenhuma agendada |
Signed webhook events, twelve typed cases | June 30, 2026 | atual | nenhuma agendada |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | atual | nenhuma agendada |
Uma linha nunca é excluída desta tabela. Se uma superfície for aposentada, ela mantém sua linha e ganha uma data, pois o objetivo de publicar uma é poder planejar contra uma remoção.
a promessa de compatibilidade
Três regras você pode construir sobre.
aditivo
Novos endpoints e novos campos de resposta são entregues em /v1. Um campo que você já analisa não muda de formato e não desaparece.
novo prefixo
Uma mudança incompatível seria entregue sob um novo prefixo de versão, em vez de dentro deste. Esse prefixo está reservado e não utilizado, e todas as versões acima aterrissaram no v1.
cabeçalhos honestos
Quando uma solicitação não consegue fazer o round-trip de algo, ela informa isso em um cabeçalho. X-Skipped-Keys e X-Missing-Source-Keys foram adicionados em vez de alterar o corpo da resposta sem aviso.
Perguntas frequentes
O que os desenvolvedores perguntam sobre versionamento e descontinuação de API.
A API Transglot é versionada?
Sim, por prefixo de URL. Tudo publicado até agora reside em /v1, que é o único prefixo em uso. Não há cabeçalho de versão, não há fixação por data e nada para configurar.
Uma atualização alguma vez quebrará minha integração?
Não dentro de /v1. Novos endpoints e novos campos de resposta são adicionados, mas um campo que você já analisa não muda de formato e não desaparece. Se uma mudança não puder ser feita de forma aditiva, ela será colocada sob um novo prefixo, e o antigo continuará funcionando.
Algo foi descontinuado ou removido?
Nada, e o registro acima diz isso 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 programada" até o final.
Quanto aviso prévio uma remoção receberia?
Uma remoção apareceria nesse registro com uma data muito antes de acontecer, e a linha permaneceria na tabela depois disso, em vez de desaparecer. Uma data contra a qual você pode planejar é exatamente o objetivo de publicar esse registro.
Como sei quando algo novo é lançado?
Cada lançamento tem uma data nesta página. O changelog do produto cobre tudo o mais que é lançado, e o console mostra um marcador quando há algo que você ainda não leu.
Por que existe um changelog separado para a API?
Porque a API carrega uma promessa de compatibilidade que um lançamento de produto não tem. Um desenvolvedor verificando se uma integração ainda funciona não deveria ter que rolar past trabalhos de funcionalidades para descobrir.
Como adiciono a API ao meu plano?
Um token bearer começa no plano Starter por $19 ao mês. O gratuito cobre o console, mas não permite gerar um token, e a CLI, a GitHub Action, webhooks e MCP ficam todos atrás desse mesmo token.
Onde está a referência dos próprios endpoints?
Na página da API: autenticação, os endpoints, o limite de taxa, os formatos de arquivo e o catálogo de webhooks. Esta página é apenas o registro do que mudou e quando.
funciona com o que você já utiliza
41 conectores, já construídos.
o contrato é o produto
Construa sobre uma API que não se move.
A API está disponível nos planos Starter e superiores. O plano gratuito é $0 com 100.000 palavras para começar (25.000 no cadastro, 75.000 após uma verificação por telefone), 10.000 por mês depois disso, e não inclui API ou webhooks.