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 fornecer 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 para uso 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. Os arquivos de recursos estão vinculados a uma 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 diferentes recursos não sobrescrevam umas às outras.
Quando você usa as configurações de CI/CD prontas para uso, 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:
- Envia os arquivos atualizados
- Identifica apenas as strings novas ou modificadas
- Traduz as strings
- Prepara os arquivos traduzidos para download
3. Um único script de CLI funciona em qualquer lugar
Em vez de chamar a API por conta própria, use a CLI da PTC:
Um único script lida com todo o fluxo (upload → consulta periódica → 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 integração via API. 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 Configurações → Tokens de API da PTC.
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 → Workflow permissions e ative Allow GitHub Actions to create and approve pull requests. O arquivo de fluxo de trabalho já solicita o acesso de gravação de que precisa; essa caixa de seleção é a única coisa que ele não pode conceder a si mesmo. |
| 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 para uso.
No GitHub Actions, adicione a PTC Translate action ao seu fluxo de trabalho. Seu token de API é a única entrada que você precisa passar. A action carrega uma versão fixa da CLI dentro de si mesma, para que seu build nunca baixe um script em tempo de execução, e quando uma execução produz novas traduções, ela abre o pull request para você.
No GitLab CI, Bitbucket Pipelines ou qualquer outra plataforma, copie a tarefa para a sua plataforma a partir dos modelos de CI/CD da CLI da PTC. Cada modelo fixa a CLI em um lançamento específico e publica o checksum para verificação, de modo que um lançamento posterior da CLI não possa alterar o que o seu build executa.
6Execute o fluxo de trabalho.
Você pode acionar o fluxo de trabalho manualmente, em commits que atualizam arquivos de recursos ou de forma programada. Veja os acionadores para GitHub, GitLab e Bitbucket. Um pull request precisa de uma branch de destino para ser aberto, portanto, no GitHub Actions, a PTC Translate action abre um em um push, de forma programada e em uma execução manual a partir de uma branch. Em um evento pull_request, pull_request_target ou merge_group, ou em uma tag ou lançamento, ela para com uma explicação em vez disso - traduza em um push para a sua branch de origem ou defina create-pr: false para essa execução.
Quando executada, a CLI envia 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 para uso e a execução produzir novas traduções, o fluxo de trabalho também abrirá um 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. Uma execução que não encontra nada para traduzir não grava nada e não abre nenhum merge request. 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 PTC Translate action
- Modelos de CI/CD para GitHub e GitLab
- Arquivo de configuração
- Fluxo de trabalho 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 são editados de forma alguma.
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 os 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.