api.transglot.ai/v1token bearer, um projetoreferência

Envie um ficheiro. Receba todos os idiomas de volta.

Uma API REST para traduzir a sua aplicação. Um POST carrega o ficheiro de origem, um GET devolve um locale concluído e um token bearer constitui toda a autenticação. Qualquer sistema que suporte HTTP pode utilizá-la.

entrada: uma chamada

curl -X POST https://api.transglot.ai/v1/push \

-H "Authorization: Bearer $TRANSGLOT_TOKEN" \

-F "file=@lang/en.json" \

-F "format=laravel_json"

202 accepted · batch queued

saída

300,000

palavras por mês no Starter, o primeiro plano que permite gerar um token.

Começar gratuitamente Ver a interface para programadores

60 pedidos por minuto por token · cada resposta 429 inclui um cabeçalho Retry-After · utilize tokens separados para CI e produção

a consola é um cliente da API

Enviar, traduzir, validar e receber, cada operação é um endpoint REST.

Cada linha na imagem abaixo tem uma rota associada: envio, validações, glossário, lotes e receção, tudo acessível a partir do seu próprio código com um token de projeto. O ambiente de testes da API na consola executa as operações de leitura ao vivo no seu projeto, para que veja primeiro uma resposta real.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Carrega um ficheiro de origem
POST/v1/push
O painel de validações é preenchido
POST/v1/qa/run
Bloqueia um termo
POST/v1/glossary
A vista de lotes faz polling automático
GET/v1/batches/:id
Recebe as traduções de volta
GET/v1/pull

uma rota por painel, 60 por minuto, capacidades por token · obter as suas traduções também é um endpoint

é apenas HTTP

Quatro coisas que as equipas criam primeiro.

cada um é um único endpoint e um token de projeto · nenhum deles demora uma tarde

portão de fusão · um ficheiro de fluxo de trabalho

Torne o pull request vermelho quando uma tradução falhar.

cron · noturno

Traduza as notas de lançamento durante a noite, todas as noites.

bot · uma subscrição

Publique no Slack assim que um lote terminar.

agente · MCP

Dê a um agente de IA as mesmas 17 ferramentas que tem.

pedidos por minuto

por token, não por conta, com um cabeçalho Retry-After em cada 429 indicando quantos segundos esperar.

formatos de ficheiro

envie e receba no formato que o seu repositório já utiliza. Os plurais e os marcadores sobrevivem em ambas as direções. Nomeie-o com format= em qualquer chamada.

eventos de webhook

todo o catálogo, cada um com uma carga útil de exemplo na forma exata que uma entrega real transporta. GET /v1/webhooks/events.

ferramentas MCP

o mesmo token de projeto, entregue a um runtime de agente em vez de ao curl. npx -y @transglot/mcp.

Perguntas frequentes

O que os programadores perguntam antes do primeiro pedido.

Como me autentico na API Transglot?

Envie um token bearer: Authorization: Bearer $TRANSGLOT_TOKEN. O token pertence a um projeto, por isso não há ID de projeto no caminho nem chave de conta para vazar. Cria tokens na página do projeto e cada um tem as suas próprias capacidades: push, pull, gerir, ler, escrever.

A API é gratuita?

Não. Um token bearer começa no plano Starter a $19 por mês. A versão gratuita abrange a consola, o que é suficiente para ver se o produto se adequa, mas não permite criar um token. A CLI, a Ação do GitHub, os webhooks, o MCP e o pacote de entrega estão todos protegidos por esse mesmo token, por isso chegam juntos.

Como faço upload de strings para a Transglot?

POST /v1/push com o ficheiro e o seu formato, por exemplo -F "file=@lang/en.json" -F "format=laravel_json". Responde 202 e coloca um lote em fila. Apenas as linhas que realmente mudaram são traduzidas, por isso enviar um ficheiro inalterado não tem custo.

Como obtenho as minhas traduções de volta?

GET /v1/pull, em qualquer um dos 20 formatos, sempre que quiser. É o endpoint que a CLI envolve e aquele que a área de testes da API executa ao vivo. Não há pedido de exportação para ficheiro nem janela em que os dados deixem de ser seus.

Qual é o limite de taxa da API?

60 pedidos por minuto, contados por token e não por conta. Se exceder este limite, receberá um erro 429 com um cabeçalho Retry-After que indica quantos segundos deve aguardar; nada será cobrado nem escrito parcialmente. Utilize tokens separados para CI e produção, para que uma compilação ruidosa não esgote os recursos da sua aplicação.

Quais idiomas a API suporta?

Não existe uma lista fixa. O validador aceita qualquer etiqueta BCP-47 reconhecida pela ICU, o que corresponde a 708 localidades na tabela de verificação, além de uma reserva estrutural para etiquetas fora desta. Adicione uma localidade ao projeto e esta será incluída no próximo envio.

Quais formatos de ficheiro posso enviar e receber?

Vinte: JSON plano e aninhado, Laravel PHP e JSON, Android XML, iOS .strings, .stringsdict e .xcstrings, Flutter ARB, XLIFF 1.2 e 2.0, gettext .po, YAML, CSV, XLSX, propriedades Java, RESX, Markdown, Unity CSV e Unreal PO. Sete deles suportam plurais e o ficheiro é devolvido no mesmo formato em que foi enviado.

O Transglot tem webhooks?

Sim. Existem 12 eventos de webhook, incluindo batch.completed, translation.reviewed, qa.completed e source_drift.repaired. Cada entrega é assinada com HMAC e inclui um cabeçalho de marca temporal para verificação, e GET /v1/webhooks/events devolve o catálogo com um exemplo de payload para cada evento.

Existe um servidor MCP para agentes de IA?

Sim. npx -y @transglot/mcp expõe 17 ferramentas através do seu token de projeto, para que um assistente possa ler uma tradução, escrever uma, adicionar um idioma, iniciar uma execução, verificar um lote ou editar o glossário. É a mesma API e as mesmas permissões, acedidas a partir de um runtime de agente em vez de curl.

Posso executá-lo em CI?

Sim. A Ação do GitHub (transglot/transglot-action@v1) e a CLI envolvem estes endpoints. Quando uma linha é recusada, transglot push --wait termina com código 4 e a Ação falha nessa execução. Para impedir uma fusão, execute-a em pull requests com o input commit definido como none, adicione um passo que falhe quando um ficheiro obtido estiver sem uma chave e torne a tarefa uma verificação obrigatória na proteção de ramos.

O que acontece quando uma tradução falha numa verificação de qualidade?

Quatro portões determinísticos leem cada linha: marcadores, plurais, termos do glossário e comprimento. Um marcador incorreto, uma forma plural em falta ou um termo proibido do glossário recebe uma nova tentativa corretiva automática e, se ainda assim falhar, a linha é recusada em vez de escrita. Uma linha que apenas exceda o seu comprimento é escrita, não recusada. GET /v1/batches/:id?include=failures lista as linhas recusadas e o motivo.

A API irá alguma vez quebrar a minha integração?

Não. A /v1 apenas adiciona endpoints e campos de resposta; um campo que já analisa não altera a sua estrutura nem desaparece. Uma alteração incompatível seria lançada sob um novo prefixo de versão, que está reservado e ainda vazio. O registo de alterações da API documenta cada lançamento.