api.transglot.ai/v1token de portador, um projetoreferência

Envie um arquivo. Receba todos os idiomas de volta.

Uma API REST para traduzir seu aplicativo. Um POST envia o arquivo de origem, um GET traz de volta a localidade finalizada e um token de portador é toda a autenticação necessária. Qualquer coisa que fale HTTP pode acioná-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 pode gerar um token.

Comece grátis Veja a interface do desenvolvedor

60 solicitações por minuto por token · cada erro 429 inclui um Retry-After · use tokens separados para CI e produção

o console é um cliente de API

Envie, traduza, valide e receba, cada um é um endpoint REST.

Cada linha na imagem abaixo tem uma rota por trás: envio, validações, glossário, lotes e recebimento, tudo acessível a partir do seu próprio código com um token de projeto. O playground de API no console executa as opções somente leitura ao vivo em seu projeto, para que você veja uma resposta real primeiro.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Você envia um arquivo de origem
POST/v1/push
O painel de validações é preenchido
POST/v1/qa/run
Você bloqueia um termo
POST/v1/glossary
A visualização do lote se atualiza automaticamente
GET/v1/batches/:id
Você recebe as traduções de volta
GET/v1/pull

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

é apenas HTTP

Quatro coisas que as equipes constroem primeiro.

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

gate de mesclagem · um arquivo de fluxo de trabalho

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

cron · nightly

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

bot · uma assinatura

Publique no Slack assim que um lote for concluído.

agente · mcp

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

requisições por minuto

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

formatos de arquivo

envie e receba no formato que seu repositório já usa. Plurais e marcadores são preservados em ambas as direções. Especifique-o com format= em qualquer chamada.

eventos de webhook

o catálogo completo, cada um com um exemplo de payload exatamente no formato de uma entrega real. GET /v1/webhooks/events.

ferramentas mcp

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

Perguntas frequentes

O que os desenvolvedores perguntam antes da primeira requisição.

Como faço para autenticar na API Transglot?

Envie um token bearer: Authorization: Bearer $TRANSGLOT_TOKEN. O token pertence a um projeto, portanto não há ID de projeto no caminho nem chave de conta vazando. Você cria tokens na página do projeto e cada um tem suas próprias permissões: push, pull, gerenciar, leitura, escrita.

A API é gratuita?

Não. Um token bearer começa no plano Starter por US$ 19 mensais. A versão gratuita cobre o console, o que é suficiente para ver se o produto atende às suas necessidades, mas não permite gerar um token. A CLI, a Ação do GitHub, webhooks, MCP e o pacote de entrega ficam todos atrás desse mesmo token, então eles chegam juntos.

Como faço para enviar strings para o Transglot?

POST /v1/push com o arquivo e seu formato, por exemplo -F "file=@lang/en.json" -F "format=laravel_json". Ele responde com 202 e coloca um lote na fila. Apenas as linhas que realmente mudaram são traduzidas, então enviar um arquivo inalterado não custa nada.

Como recupero minhas traduções?

GET /v1/pull, em qualquer um dos 20 formatos, quando quiser. É o endpoint que a CLI encapsula e que o playground da API executa ao vivo. Não há solicitação de exportação para arquivo nem janela em que os dados deixem de ser seus.

Qual é o limite de taxa da API?

60 requisições por minuto, contadas por token em vez de por conta. Ao exceder, você recebe um erro 429 com um cabeçalho Retry-After indicando quantos segundos esperar, e nada é cobrado ou escrito parcialmente. Use tokens separados para CI e produção para que uma build ruidosa não prejudique seu app.

Quais idiomas a API suporta?

Não há uma lista fixa. O validador aceita qualquer tag BCP-47 reconhecida pela ICU, que são 708 localidades na tabela verificada, além de um fallback estrutural para tags fora dela. Adicione uma localidade ao projeto e o próximo push a incluirá.

Quais formatos de arquivo 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 arquivo retorna no mesmo formato em que foi enviado.

O Transglot tem webhooks?

Sim. Há 12 eventos de webhook, incluindo batch.completed, translation.reviewed, qa.completed e source_drift.repaired. Cada entrega é assinada com HMAC e possui um cabeçalho de timestamp para que você possa verificá-la, e GET /v1/webhooks/events retorna o catálogo com um payload de exemplo para cada um.

Existe um servidor MCP para agentes de IA?

Sim. npx -y @transglot/mcp expõe 17 ferramentas por meio do token do seu 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, acessadas a partir de um runtime de agente em vez de curl.

Posso executá-lo na CI?

Sim. A GitHub Action (transglot/transglot-action@v1) e a CLI encapsulam esses endpoints. Quando uma linha é recusada, transglot push --wait sai com código 4 e a Action falha a tarefa naquela execução. Para impedir uma mesclagem, execute-a em pull requests com sua entrada de commit definida como none, adicione uma etapa que falhe quando um arquivo extraído estiver faltando uma chave e torne a tarefa uma verificação obrigatória na proteção de branch.

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

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

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

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