Integre a localização ao seu pipeline de CI/CD com a API da PTC
Aprenda a integrar a API da PTC ao seu pipeline de CI/CD para entregar traduções por IA com qualidade humana como parte do seu processo de build.
Seguro por design — não requer acesso de leitura ou gravação ao repositório.- Compatível com qualquer sistema de CI/CD, com configurações prontas incluídas.
- Acesso controlado por meio de tokens de API específicos do projeto.
- Traduções com qualidade humana entregues em minutos, diretamente no seu build.
Como a integração de CI/CD funciona
Antes de configurar a PTC com o seu sistema de CI, aqui estão os três princípios por trás da API e da CLI da PTC:
1. Arquivos de recursos estão vinculados a um branch
Cada arquivo que você envia para a PTC está vinculado a um nome de branch (ex.: main, feature/new-checkout). Isso mantém as traduções separadas, para que traduções de recursos diferentes não sobrescrevam umas às outras.
Quando você usa as configurações prontas de CI/CD, esse mapeamento já é tratado automaticamente.
2. As traduções são processadas de forma assíncrona
A PTC não retorna as traduções imediatamente. Em vez disso, ela:
- Faz o upload dos arquivos atualizados
- Identifica apenas as strings novas ou modificadas
- Traduz as strings
- Prepara os arquivos traduzidos para download
3. Um script de CLI funciona em qualquer lugar
Em vez de chamar a API por conta própria, use a CLI da PTC:
Um script lida com todo o fluxo (upload → poll → download). A CLI roda em Linux e macOS e funciona com GitHub Actions, GitLab, Bitbucket ou qualquer outra plataforma de CI/CD.
Fluxo de alto nível: configure a API da PTC no seu pipeline de CI/CD
1Inscreva-se para um teste.
Obtenha acesso total a todos os recursos e traduza até 20.000 palavras para quaisquer dois idiomas que você escolher.
2Crie um novo projeto.
Ao escolher como usar a PTC, selecione API integration. Durante a configuração, você fornecerá um pouco de contexto sobre o seu projeto (o que ele faz, para quem é) e selecionará os idiomas para os quais deseja traduzir.
3Obtenha seu token de API.
No final da configuração, você receberá um token de API específico do projeto. Copie-o e guarde-o com segurança — você precisará dele para autenticar todas as solicitações. Você sempre pode encontrar o mesmo token novamente no painel do seu projeto em Settings → PTC API tokens.
4Adicione o token de API da PTC ao seu repositório no local correto.
| Provedor | Onde adicionar o token |
|---|---|
| GitHub Actions | Vá para Settings → Secrets and variables → Actions e adicione PTC_API_TOKEN. Em seguida, vá para Settings → Actions → General e ative Workflow permissions para que o workflow possa criar pull requests. |
| GitLab CI/CD | Vá para Settings → CI/CD → Variables e adicione PTC_API_TOKEN. |
| Bitbucket Pipelines | Vá para Repository settings → Pipelines → Repository variables e adicione PTC_API_TOKEN. |
5Copie a configuração de CI/CD pronta.
No GitHub Actions, adicione a action PTC Translate ao seu workflow. Seu token de API é a única entrada que você precisa passar. A action carrega uma versão fixa da CLI dentro de si, para que o seu build nunca baixe um script em tempo de execução, e ela abre o pull request de tradução para você.
No GitLab CI, no Bitbucket Pipelines ou em qualquer outra plataforma, copie o job da sua plataforma nos templates de CI/CD da CLI da PTC. Cada template fixa a CLI em uma versão específica e publica o checksum para verificação, para que uma versão posterior da CLI não possa alterar o que o seu build executa.
6Execute o workflow.
Você pode acionar o workflow manualmente, em commits que atualizam arquivos de recursos ou de forma programada. Veja os gatilhos para GitHub, GitLab e Bitbucket.
Quando executada, a CLI faz o upload dos seus arquivos, aguarda a conclusão das traduções e grava as traduções atualizadas de volta no seu repositório. Se você estiver usando as configurações prontas, o workflow também irá create a merge request com as alterações, para que você possa revisá-las e fazer o merge como qualquer outra atualização de código. A partir daqui, suas traduções permanecem sincronizadas automaticamente.
Exemplos de CI/CD
WordPress
Ruby on Rails
Arquivos JSON (Aplicativos React)Leitura adicional
- Entradas da action PTC Translate
- Templates de CI/CD para GitHub e GitLab
- Arquivo de configuração
- Workflow de processamento
- Solução de problemas
Por que usar a PTC para traduções de software?
A PTC é um sistema de tradução completo para desenvolvedores e equipes de produto — construído para manter seu código, sua marca e seu público em sincronia.
Traduções sensíveis ao contexto que protegem sua marca
Antes de traduzir, a PTC aprende sobre o seu produto, o seu público e a sua terminologia. É por isso que 99,5% das frases vão ao ar sem edições, e 85% dos projetos não recebem nenhuma edição.
Como as traduções por IA da PTC protegem sua marca →
Amplo suporte a plataformas e formatos de arquivo
A PTC funciona com as plataformas e os formatos de arquivos de recursos mais populares, incluindo: Android, iOS, React, Vue.js, Angular, Ruby on Rails, JavaScript, Adobe Commerce (Magento), Shopify e WordPress.
Mais sobre formatos de arquivo suportados →
Traduza mais do que arquivos de recursos
Precisa traduzir notas de lançamento, e-mails ou documentação? A PTC também inclui um recurso rápido de “Paste to translate” que oferece as mesmas traduções sensíveis ao contexto para textos fora do código.
Como traduzir textos fora de arquivos de recursos →
Automatize as traduções no seu CI/CD
Configure a PTC uma vez, e seus arquivos de recursos e traduções permanecerão atualizados automaticamente no seu pipeline de CI/CD.