Intégrez la localisation dans votre pipeline CI/CD avec l'API de PTC
Découvrez comment intégrer l'API de PTC dans votre pipeline CI/CD pour fournir des traductions par IA de qualité humaine dans le cadre de votre processus de build.
Sécurisé par conception — aucun accès en lecture ou en écriture au dépôt n'est requis.- Compatible avec n'importe quel système CI/CD, avec des configurations prêtes à l'emploi incluses.
- Accès contrôlé via des jetons d'API spécifiques au projet.
- Des traductions de qualité humaine livrées en quelques minutes, directement dans votre build.
Comment fonctionne l'intégration CI/CD
Avant de configurer PTC avec votre système CI, voici les trois principes qui régissent l'API et la CLI de PTC :
1. Les fichiers de ressources sont liés à une branche
Chaque fichier que vous envoyez à PTC est lié à un nom de branche (par exemple main, feature/new-checkout). Cela permet de séparer les traductions, afin que les traductions de différentes fonctionnalités ne s'écrasent pas entre elles.
Lorsque vous utilisez les configurations CI/CD prêtes à l'emploi, ce mappage est déjà géré automatiquement.
2. Les traductions sont traitées de manière asynchrone
PTC ne renvoie pas les traductions immédiatement. Au lieu de cela, il :
- téléverse les fichiers mis à jour
- identifie uniquement les chaînes nouvelles ou modifiées
- traduit les chaînes
- prépare les fichiers traduits pour le téléchargement
3. Un seul script CLI fonctionne partout
Au lieu d'appeler l'API vous-même, utilisez la CLI de PTC :
Un seul script gère l'ensemble du flux (upload → poll → download). La CLI fonctionne sur Linux et macOS, et s'intègre à GitHub Actions, GitLab, Bitbucket ou toute autre plateforme CI/CD.
Flux de haut niveau : configurer l'API de PTC dans votre pipeline CI/CD
1Inscrivez-vous pour un essai gratuit.
Bénéficiez d'un accès complet à toutes les fonctionnalités et traduisez jusqu'à 20 000 mots dans la paire de langues de votre choix.
2Créez un nouveau projet.
Lorsque vous choisissez comment utiliser PTC, sélectionnez API integration. Lors de la configuration, vous fournirez un peu de contexte sur votre projet (ce qu'il fait, à qui il s'adresse) et sélectionnerez les langues cibles souhaitées.
3Obtenez votre jeton d'API.
À la fin de la configuration, vous recevrez un jeton d'API spécifique au projet. Copiez-le et conservez-le en lieu sûr — vous en aurez besoin pour authentifier toutes les requêtes. Vous pourrez toujours retrouver ce même jeton dans le tableau de bord de votre projet sous Settings → PTC API tokens.
4Ajoutez le jeton d'API de PTC à votre dépôt au bon endroit.
| Fournisseur | Où ajouter le jeton |
|---|---|
| GitHub Actions | Allez dans Settings → Secrets and variables → Actions et ajoutez PTC_API_TOKEN. Allez ensuite dans Settings → Actions → General et activez les Workflow permissions afin que le workflow puisse créer des pull requests. |
| GitLab CI/CD | Allez dans Settings → CI/CD → Variables et ajoutez PTC_API_TOKEN. |
| Bitbucket Pipelines | Allez dans Repository settings → Pipelines → Repository variables et ajoutez PTC_API_TOKEN. |
5Copiez la configuration CI/CD prête à l'emploi.
Vous pouvez obtenir la configuration CI/CD prête à l'emploi pour votre plateforme sur le wiki de la CLI de PTC. Ces modèles incluent déjà les étapes pour télécharger et exécuter la CLI.
6Exécutez le workflow.
Vous pouvez déclencher le workflow manuellement, lors de commits qui mettent à jour des fichiers de ressources, ou selon une planification. Consultez les déclencheurs pour GitHub, GitLab et Bitbucket.
Lorsqu'elle s'exécute, la CLI téléverse vos fichiers, attend que les traductions soient terminées et réécrit les traductions mises à jour dans votre dépôt. Si vous utilisez les configurations prêtes à l'emploi, le workflow créera également une pull/merge request avec les modifications, afin que vous puissiez les réviser et les fusionner comme n'importe quelle autre mise à jour de code. À partir de là, vos traductions restent synchronisées automatiquement.
Exemples CI/CD
Lectures complémentaires
Pourquoi utiliser PTC pour les traductions de logiciels ?
PTC est un système de traduction complet pour les développeurs et les équipes produit — conçu pour maintenir votre code, votre marque et votre audience en phase.
Des traductions contextuelles qui protègent votre voix de marque
Avant de traduire, PTC s'informe sur votre produit, votre audience et votre terminologie. C'est pourquoi 99,5 % des phrases sont mises en ligne sans modification, et 85 % des projets ne sont pas modifiés du tout.
Comment les traductions par IA de PTC protègent votre marque →
Large prise en charge des plateformes et des formats de fichiers
PTC fonctionne avec les formats de fichiers de ressources et les plateformes les plus populaires, notamment : Android, iOS, React, Vue.js, Angular, Ruby on Rails, JavaScript, Adobe Commerce (Magento), Shopify et WordPress.
En savoir plus sur les formats de fichiers pris en charge →
Traduisez plus que des fichiers de ressources
Besoin de traduire des notes de version, des e-mails ou de la documentation ? PTC inclut également une fonctionnalité rapide « Coller pour traduire » qui vous offre les mêmes traductions contextuelles pour les textes en dehors du code.
Comment traduire du texte en dehors des fichiers de ressources →
Automatisez les traductions dans votre CI/CD
Configurez PTC une seule fois, et vos fichiers de ressources ainsi que vos traductions resteront à jour automatiquement dans votre pipeline CI/CD.