Aprenda a integrar la API de PTC en su canalización de CI/CD para ofrecer traducciones de IA con calidad humana como parte de su proceso de compilación.
Seguro por diseño: no se requiere acceso de lectura ni escritura al repositorio.
Compatible con cualquier sistema CI/CD, con configuraciones listas para usar incluidas.
Acceso controlado a través de tokens de API específicos del proyecto.
Traducciones de calidad humana entregadas en minutos, directamente en su compilación.
En esta página
Cómo funciona la integración de CI/CD
Antes de configurar PTC con su sistema de CI, estos son los tres principios detrás de la API y la CLI de PTC:
1
Los archivos de recursos están vinculados a una rama
Cada archivo que envía a PTC está vinculado a un nombre de rama (p. ej., main, feature/new-checkout). Esto mantiene las traducciones separadas, por lo que el trabajo de diferentes funciones no se sobrescribe entre sí.
Cuando utiliza las configuraciones de CI/CD listas para usar, esta asignación ya se gestiona automáticamente.
2
Las traducciones se procesan de forma asíncrona
PTC no devuelve las traducciones inmediatamente. En cambio, hace lo siguiente:
- Prepara los archivos traducidos para su descarga
- Carga los archivos actualizados
- Identifica solo las cadenas nuevas o modificadas
- Traduce las cadenas
3
Un script de CLI funciona en todas partes
En lugar de llamar a la API usted mismo, utilice la CLI de PTC:
Un script gestiona todo el flujo (carga → sondeo → descarga). La CLI está alojada en GitHub, pero funciona en Linux, macOS, GitHub Actions, GitLab, Bitbucket o cualquier otra plataforma de CI/CD.
Flujo de alto nivel: configure la API de PTC en su canalización de CI/CD
Obtenga acceso completo a todas las funciones y traduzca hasta 2500 palabras a dos idiomas de su elección.
Paso 2
Cree un nuevo proyecto.
Al elegir cómo usar PTC, seleccione Integración de API. Durante la configuración, proporcionará un poco de contexto sobre su proyecto (qué hace, para quién es) y seleccionará los idiomas a los que desea traducir.
Paso 3
Obtenga su token de API.
Al final de la configuración, recibirá un token de API específico del proyecto. Cópielo y guárdelo en un lugar seguro, ya que lo necesitará para autenticar todas las solicitudes. Siempre puede encontrar el mismo token en el panel de control de su proyecto en Ajustes → Tokens de API de PTC.
Paso 4
Añada el token de API de PTC a su repositorio en la ubicación correcta.
| Proveedor | Dónde añadir el token |
|---|---|
| Acciones de GitHub | Vaya a Settings → Secrets and variables → Actions y añada PTC_API_TOKEN. Luego, vaya a Settings → Actions → General y habilite Workflow permissions para que el flujo de trabajo pueda crear solicitudes de extracción. |
| GitLab CI/CD | Vaya a Settings → CI/CD → Variables y añada PTC_API_TOKEN. |
| Canalizaciones de Bitbucket | Vaya a Repository settings → Pipelines → Repository variables y añada PTC_API_TOKEN. |
Paso 5
Copie la configuración de CI/CD lista para usar.
You can get the ready-made CI/CD configuration for your platform from the PTC CLI wiki. These templates already include the steps to download and run the CLI.
Paso 6
Ejecute el flujo de trabajo.
Puede activar el flujo de trabajo manualmente, en confirmaciones que actualizan los archivos de recursos o en una programación. Consulte los desencadenadores para GitHub, GitLab y Bitbucket.
Cuando se ejecuta, la CLI carga sus archivos, espera a que terminen las traducciones y vuelve a escribir las traducciones actualizadas en su repositorio. Si está utilizando las configuraciones listas para usar, el flujo de trabajo también creará una solicitud de extracción/fusión con los cambios, para que pueda revisarlos y fusionarlos como cualquier otra actualización de código. A partir de aquí, sus traducciones permanecen sincronizadas automáticamente.
Ejemplos de CI/CD
WordPress
Ruby on rails
Archivos JSON (aplicaciones de React)
Lecturas adicionales
¿Por qué usar PTC para traducciones de software?
PTC es un sistema de traducción completo para desarrolladores y equipos de productos, creado para mantener su código, marca y audiencia sincronizados.
Traducciones con reconocimiento de contexto que protegen su marca
Antes de traducir, PTC aprende sobre su producto, su audiencia y su terminología. Es por eso que el 99,5% de las oraciones se publican sin ediciones y el 85% de los proyectos no se editan en absoluto.
Amplia compatibilidad con plataformas y formatos de archivo
PTC funciona con los formatos de archivo de recursos y las plataformas más populares, incluidos:
Android, iOS, React, Vue.js, Angular, Ruby on Rails, JavaScript, Adobe Commerce (Magento), Shopify y WordPress.
Traduzca más que archivos de recursos
¿Necesita traducir notas de la versión, correos electrónicos o documentación? PTC también incluye una función rápida de “Pegar para traducir” que le brinda las mismas traducciones con reconocimiento de contexto para texto fuera del código.
Automatice las traducciones en su CI/CD
Configure PTC una vez, y sus archivos de recursos y traducciones se mantendrán actualizados automáticamente en su canalización de CI/CD.
