Scopri come integrare l’API PTC nella tua pipeline CI/CD per fornire traduzioni AI di qualità umana come parte del tuo processo di build.
Sicuro per design — nessun accesso in lettura o scrittura al Repository richiesto.
Compatibile con qualsiasi sistema CI/CD, con configurazioni predefinite incluse.
Accesso controllato tramite token API specifici per progetto.
Traduzioni di qualità umana consegnate in pochi minuti, direttamente nella tua build.
In questa pagina
Come funziona l’integrazione CI/CD
Prima di configurare PTC con il tuo sistema CI, ecco i tre principi alla base dell’API e della CLI PTC:
1
I file di risorse sono legati a un branch
Ogni file che invii a PTC è collegato a un nome di branch (ad es. main, feature/new-checkout). Questo mantiene le traduzioni separate, in modo che il lavoro di diverse funzionalità non si sovrascriva a vicenda.
Quando utilizzi le configurazioni CI/CD predefinite, questa mappatura viene già gestita automaticamente.
2
Le traduzioni vengono elaborate in modo asincrono
PTC non restituisce le traduzioni immediatamente. Invece, procede come segue:
- Prepara i file tradotti per il download
- Carica i file aggiornati
- Identifica solo le stringhe nuove o modificate
- Traduce le stringhe
3
Un unico script CLI funziona ovunque
Invece di chiamare l’API direttamente, usa la CLI PTC:
Un unico script gestisce l’intero flusso (caricamento → polling → download). La CLI è ospitata su GitHub ma funziona su Linux, macOS, GitHub Actions, GitLab, Bitbucket o qualsiasi altra piattaforma CI/CD.
Flusso di alto livello: configura l’API PTC nella tua pipeline CI/CD
Passaggio 1
La prova gratuita ti dà accesso illimitato a tutte le funzionalità.
Passaggio 2
Crea un nuovo progetto.
Quando scegli come usare PTC, seleziona integrazione API. Durante la configurazione, fornirai un po’ di contesto sul tuo progetto (cosa fa, a chi è destinato) e selezionerai le lingue in cui vuoi tradurre.
Passaggio 3
Ottieni il tuo token API.
Al termine della configurazione, riceverai un token API specifico per il progetto. Copialo e conservalo in un luogo sicuro: ti servirà per autenticare tutte le richieste. Puoi sempre trovare lo stesso token nella dashboard del tuo progetto in Impostazioni → Token API PTC.
Passaggio 4
Aggiungi il token API PTC al tuo Repository nella posizione corretta.
| Provider | Dove aggiungere il token |
|---|---|
| GitHub Actions | Vai a Settings → Secrets and variables → Actions e aggiungi PTC_API_TOKEN. Poi vai a Settings → Actions → General e abilita Workflow permissions in modo che il workflow possa creare pull request. |
| GitLab CI/CD | Vai a Settings → CI/CD → Variables e aggiungi PTC_API_TOKEN. |
| Pipeline Bitbucket | Vai a Repository settings → Pipelines → Repository variables e aggiungi PTC_API_TOKEN. |
Passaggio 5
Copia la configurazione CI/CD predefinita.
Puoi ottenere la configurazione CI/CD predefinita per la tua piattaforma dalla wiki della CLI PTC. Questi modelli includono già i passaggi per scaricare ed eseguire la CLI.
Passaggio 6
Esegui il workflow.
Puoi attivare il workflow manualmente, sui commit che aggiornano i file di risorse o in base a una pianificazione. Vedi i trigger per GitHub, GitLab e Bitbucket.
Quando viene eseguito, la CLI carica i tuoi file, attende il completamento delle traduzioni e riscrive le traduzioni aggiornate nel tuo Repository. Se stai usando le configurazioni predefinite, il workflow creerà anche una pull/merge request con le modifiche, così potrai rivederle e unirle come qualsiasi altro aggiornamento di codice. Da qui in poi, le tue traduzioni rimarranno automaticamente sincronizzate.
Esempi CI/CD
WordPress
Ruby on rails
File JSON (app React)
Ulteriori letture
Perché usare PTC per le traduzioni software?
PTC è un sistema di traduzione completo per sviluppatori e team di prodotto — costruito per mantenere il tuo codice, il tuo brand e il tuo pubblico sincronizzati.
Traduzioni contestualizzate che proteggono il tuo brand
Prima di tradurre, PTC apprende informazioni sul tuo prodotto, sul tuo pubblico e sulla tua terminologia. Ecco perché il 99,5% delle frasi va online senza modifiche e l’85% dei progetti non viene modificato affatto.
Ampio supporto per piattaforme e formati di file
PTC funziona con i formati di file di risorse e le piattaforme più popolari, tra cui:
Android, iOS, React, Vue.js, Angular, Ruby on Rails, JavaScript, Adobe Commerce (Magento), Shopify e WordPress.
Traduci più che semplici file di risorse
Hai bisogno di tradurre note di rilascio, email o documentazione? PTC include anche una rapida funzione “Incolla per tradurre” che ti offre le stesse traduzioni contestualizzate per il testo al di fuori del codice.
Automatizza le traduzioni nel tuo CI/CD
Configura PTC una volta, e i tuoi file di risorse e le traduzioni rimarranno aggiornati automaticamente nella tua pipeline CI/CD.
