transglot para desenvolvedoresapi, cli, mcp

Traduza suas strings pela CI, não por um painel.

Veja seu site em francês, alemão e espanhol, gratuitamente.Sem cadastro. Sem configuração.

Uma API REST com tokens escopados, 12 eventos de webhook assinados com HMAC, um servidor MCP que seu editor pode chamar e 20 formatos de arquivo que fazem round-trip sem reescrever o esquema. Envie o arquivo e receba os idiomas de volta.

Leia a página da API Comece grátis

Sem

Com

Um painel que alguém precisa lembrar de abrir.

A CLI e a Ação do GitHub executam na CI com um token de projeto escopado, a partir do plano Starter.

Um conversor de formato no meio, descartando silenciosamente plurais e comentários.

Vinte formatos lidos e gravados nativamente, para que plurais, marcadores e comentários sobrevivam ao ciclo completo.

Consultar um endpoint para descobrir se a execução foi concluída.

12 eventos de webhook, assinados sobre o timestamp e o corpo, para que seu receptor possa impor sua própria janela de replay.

Envie um arquivo de strings e receba idiomas em rascunho com as quatro verificações já executadas. Um token de projeto aciona a CLI, a Ação do GitHub, a API REST e o servidor MCP, e o limite é de 60 solicitações por minuto por token.

Referência da API Changelog da API

como funciona

Seu arquivo entra como está. Placeholders e plurais voltam intactos.

cinco etapas: 20 formatos lidos como estão, um token escopo, a passagem de tradução, a verificação de placeholder, um webhook assinado e então o pull

soluções · console de rotasolutions / developersDesenvolvedores

o que entra20 formatos, como estãoplurais, placeholders e comentários sobrevivem ao ciclo completo

como chega láAPI, CLI, Ação ou MCPum token de projeto único impulsiona os quatro; sessenta solicitações por minuto

qual passagemFlux no push, Deep por chaveo passe rápido em cada commit; o cuidadoso nas chaves que você sinalizarFluxoProfundoambas as passagens, escolhidas por chave

a verificaçãoA verificação de placeholderum {token} renomeado ou reordenado é recusado, nunca adivinhadoplaceholderspluralsglossarylengtha verificação que captura aqui

o que resultaUm webhook assinado, depois pull12 eventos assinados sobre carimbo de data/hora e corpo; /v1/pull recupera todas as strings

uma primeira semana ilustrativaDesenvolvedores

$ transglot push

POST /v1/push · 200 · abilities: push, pull

placeholders · {amount} kept in every locale

webhook · signed over timestamp + body · delivered

$ transglot pull

3 locales written back, schema untouched

o plano adequado

Inicial$19por mês

300.000 palavras por mês
Projetos e idiomas ilimitados, três assentos
O token escopo que o Free não pode gerar: CLI, Action, API, MCP

O plano gratuito não exige cartão, mas não pode gerar um token de projeto, então as cinco superfícies começam aqui.

Ver todas as oito páginas

todas começam no mesmo plano gratuito

Um recurso fixo, no seu navegador. As cinco etapas, as duas passagens, as quatro verificações e as linhas do plano são o mecanismo entregue e a lista de preços entregue; a fita da primeira semana é ilustrativa e nada nesta placa é enviado para lugar algum.

Uma ferramenta de tradução, versus uma etapa de build.

Uma ferramenta de tradução, versus
O que está sendo comparado	Transglotno pipeline	Um painel no qual você faz loginfora da banda
Onde é executado	Na CI. A GitHub Action gera rascunhos ao fazer push, e a CLI faz o mesmo a partir do seu shell.	Em uma aba do navegador que alguém precisa lembrar de abrir.
Autenticação	Tokens de projeto com cinco capacidades: push, pull, gerenciar, leitura e escrita, com um subconjunto de implantação de três capacidades.	Um login compartilhado e uma senha no cofre da equipe.
Eventos	12 eventos de webhook, assinados com HMAC sobre o carimbo de data/hora e o corpo.	Um resumo diário por e-mail.
Formatos	Vinte formatos, lidos e escritos nativamente. Sete deles suportam plurais, e um formato que não pode expressar uma forma plural recusa a linha em vez de inventar uma.	CSV e um conversor que você mantém.
Agentes	Um servidor MCP que expõe 17 ferramentas MCP, permitindo que um editor traduza o que estiver faltando ou execute QA sem sair do arquivo.	Copiar, colar e torcer.

Transglot

no pipeline

Onde é executado: Na CI. A GitHub Action gera rascunhos ao fazer push, e a CLI faz o mesmo a partir do seu shell.
Autenticação: Tokens de projeto com cinco capacidades: push, pull, gerenciar, leitura e escrita, com um subconjunto de implantação de três capacidades.
Eventos: 12 eventos de webhook, assinados com HMAC sobre o carimbo de data/hora e o corpo.
Formatos: Vinte formatos, lidos e escritos nativamente. Sete deles suportam plurais, e um formato que não pode expressar uma forma plural recusa a linha em vez de inventar uma.
Agentes: Um servidor MCP que expõe 17 ferramentas MCP, permitindo que um editor traduza o que estiver faltando ou execute QA sem sair do arquivo.

As contagens de formato, evento e ferramenta acima estão fixadas nos enums dos quais provêm por testes que falham quando a cópia diverge.

o que você pode chamar

Cinco formas de acesso, um token de projeto.

Todos os cinco autenticam com o mesmo token com escopo definido, que o plano Free não pode emitir. Eles começam no plano Starter.

cli
transglot push e transglot pull
Lê o arquivo que você já tem e escreve os locales rascunhados de volta nele. Licenciado sob MIT e publicado no npm.
Starter e superiores
action
A GitHub Action
transglot/transglot-action faz rascunhos no push e envia os locales para a mesma branch. Licenciado sob MIT, e o repositório é público.
github.com
api
A API REST
Sessenta solicitações por minuto por token. O endpoint de extração é a forma suportada para recuperar todas as strings.
/api
mcp
O servidor MCP
Seu agente chama 17 ferramentas MCP diretamente, quatro das quais são o conjunto CRUD do glossário.
Starter e superiores
cdn
O pacote de localidade na CDN
Publique um pacote JSON de localidade e leia-o na borda em tempo de execução, em vez de lançar uma nova build para corrigir um texto.
Starter e superiores

Não há download de traduções no navegador, intencionalmente. As formas de saída são o endpoint de extração, a CLI, o pacote da CDN e a sincronização com armazenamento de arquivos.

FAQs

O que um desenvolvedor verifica antes de escrever a primeira chamada.

Existe uma API de tradução que eu possa chamar do meu próprio código?

Sim: uma API REST v1, uma CLI no npm, uma GitHub Action, um servidor MCP com 17 ferramentas e 12 eventos de webhook assinados. Todos os cinco autenticam com o mesmo token de projeto com escopo, que o plano gratuito não pode emitir, portanto eles começam no Starter, a US$ 19 por mês.

O que o plano gratuito realmente me oferece?

Um projeto, 100.000 palavras para começar (25.000 no cadastro, 75.000 após verificação por telefone) e 10.000 por mês depois, três assentos e 15 linhas de localidade, incluindo a origem, o que significa 14 idiomas de destino. Ele não pode emitir um token de projeto, então a CLI, a Action, a API, os webhooks e o servidor MCP começam no Starter.

Como incluo a tradução no meu pipeline de CI?

Adicione a GitHub Action. Ela faz o rascunho de cada idioma mapeado no push e os envia para a branch em que o workflow foi executado, de modo que, em uma branch de feature, as traduções chegam ao pull request dessa branch, junto com a alteração, e não depois dela. A CLI envia e baixa dados de qualquer outro executor e, com --wait, ela sai com código diferente de zero quando uma execução falha, o que deixa a etapa vermelha em vez de permitir que uma linha recusada passe silenciosamente.

Qual é o limite de taxa da API?

Sessenta solicitações por minuto por token de projeto. É por token, e não por organização, para que um trabalho de CI ruidoso não prejudique seu leitor de produção.

Como os webhooks são assinados e como evito replays?

Cada entrega carrega um cabeçalho de timestamp e uma assinatura HMAC computada sobre o timestamp e o corpo. Publicamos o timestamp para que seu receptor possa impor a janela de replay que desejar; nós não impomos uma para você.

Quais eventos de webhook vocês enviam?

12 eventos de webhook: batch.completed, batch.failed, key.created, key.updated, key.deleted, translation.updated, translation.reviewed, language.added, language.removed, glossary.updated, qa.completed e source_drift.repaired. A mesma lista pode ser lida em GET /v1/webhooks/events, para que seu código nunca precise codificá-la rigidamente.

O que um token de projeto pode fazer e posso restringir seu escopo?

Um token possui cinco capacidades: push, pull, manage, read e write, e há um subconjunto de deploy com três capacidades para um trabalho que só precisa mover arquivos. Os tokens são gerados por projeto, portanto um não pode acessar um projeto para o qual não foi criado.

Quais formatos de arquivo mantêm os plurais?

Sete dos vinte: Android XML, iOS stringsdict, iOS xcstrings, Flutter ARB, gettext PO, CSV e XLSX. Laravel PHP não suporta e, em vez de inventar um formato, seu codec recusa a linha.

Há um servidor MCP para meu agente de codificação?

Sim, com 17 ferramentas, para que um agente possa ler um projeto, listar e adicionar idiomas, obter e atualizar uma única tradução, baixar e enviar arquivos inteiros, traduzir o que estiver faltando, monitorar ou cancelar um lote, repetir um que falhou e executar QA sem sair do editor. Quatro das dezessete são as ferramentas do glossário. Cancelar um lote devolve as palavras não gastas à sua cota.

O que acontece quando uma tradução falha em uma verificação?

Um marcador quebrado, uma forma plural ausente ou um termo proibido do glossário recebe uma tentativa automática de correção, e as verificações são executadas novamente no resultado. Se ainda falhar, a linha é recusada em vez de ser escrita no seu arquivo. Uma linha que apenas excede o comprimento é escrita, e no plano Team a aprovação automática ou uma execução de QA a sinaliza para revisão.

Posso alterar uma string sem lançar uma nova build?

Na web, sim. Publique um pacote de localidade na CDN a partir do plano Starter e leia-o em tempo de execução, assim uma correção de texto é uma publicação, não um lançamento. Aplicativos nativos ainda obtêm suas strings dos formatos de arquivo e precisam de uma build.

Como recupero todas as strings?

GET /v1/pull, a CLI, o pacote da CDN ou a sincronização de armazenamento de arquivos com S3, Dropbox ou Drive. Não há download de traduções pelo navegador propositalmente, então planeje usar uma dessas quatro rotas.

Alguma parte é open source?

A CLI tem licença MIT e é publicada no npm, e a GitHub Action tem licença MIT com um repositório público. O aplicativo hospedado em si, incluindo o motor e os codecs de formato, é privado, e nada neste site deve ser interpretado como dizendo o contrário.