transglot per sviluppatoriapi, cli, mcp

Traduci le tue stringhe dalla CI, non da una dashboard.

Visualizza il tuo sito in francese, tedesco e spagnolo, gratuitamente.Nessuna registrazione. Nessuna configurazione.

Un'API REST con token con ambito, 12 eventi webhook firmati con HMAC, un server MCP che il tuo editor può chiamare e 20 formati di file che supportano il round-trip senza riscrittura dello schema. Invia il file, ricevi le lingue.

Leggi la pagina dell'API Inizia gratis

Senza

Con

Una dashboard che qualcuno deve ricordarsi di aprire.

La CLI e l'Azione GitHub vengono eseguite nella CI con un token di progetto con ambito, a partire da Starter.

Un convertitore di formato nel mezzo, che elimina silenziosamente plurali e commenti.

Venti formati letti e scritti nativamente, così plurali, segnaposto e commenti sopravvivono al round-trip.

Interrogare un endpoint per scoprire se l'esecuzione è terminata.

12 eventi webhook, firmati su timestamp e corpo, così il tuo ricevitore può applicare la propria finestra di replay.

Invia un file di stringhe, ricevi le bozze delle lingue con i quattro controlli già eseguiti. Un unico token di progetto gestisce la CLI, l'Azione GitHub, l'API REST e il server MCP, con un limite di 60 richieste al minuto per token.

Riferimento API Changelog API

come funziona

Il tuo file viene inserito così com’è. Segnaposto e plurali tornano intatti.

cinque passaggi: 20 formati letti così come sono, un token con ambito definito, la fase di traduzione, il controllo dei segnaposto, un webhook firmato e poi il pull

soluzioni · console di routingsolutions / developersSviluppatori

ciò che entra20 formati, così come sonoplurali, segnaposto e commenti sopravvivono al ciclo completo

come arriva lìAPI, CLI, Action o MCPun unico token di progetto con ambito definito gestisce tutti e quattro, sessanta richieste al minuto

quale passFlux al push, Deep per chiavela fase veloce su ogni commit; quella accurata sulle chiavi che segnaliFluxDeepentrambi i passaggi, scelti per chiave

il controlloIl controllo dei segnapostoun {token} rinominato o riordinato viene rifiutato, mai ipotizzatosegnapostopluraliglossariolunghezzail controllo che lo intercetta qui

ciò che esceUn webhook firmato, poi il pull12 eventi firmati su timestamp e corpo; /v1/pull estrae tutte le stringhe

una prima settimana esemplificativaSviluppatori

$ transglot push

POST /v1/push · 200 · abilities: push, pull

placeholders · {amount} kept in every locale

webhook · signed over timestamp + body · delivered

$ transglot pull

3 locales written back, schema untouched

il piano su misura

Base$19al mese

300.000 parole al mese
Progetti e lingue illimitati, tre posti
Il token con ambito Free non può generare: CLI, Action, API, MCP

Il piano Free non richiede carta di credito, ma non può generare un token di progetto, quindi le cinque superfici iniziano da qui.

Vedi tutte le otto pagine

ogni singolo inizia con lo stesso piano gratuito

Un componente fisso, nel tuo browser. I cinque passaggi, i due flussi, i quattro controlli e le righe del piano sono il meccanismo rilasciato e il listino prezzi rilasciato; la registrazione della prima settimana è solo esemplificativa e nulla di quanto mostrato viene inviato da nessuna parte.

Uno strumento di traduzione, contro un passaggio di build.

Uno strumento di traduzione, contro
Cosa viene confrontato	Transglotnella pipeline	Una dashboard in cui accedifuori banda
Dove viene eseguito	Nella CI. L'Azione GitHub crea bozze al push e la CLI fa lo stesso dalla tua shell.	In una scheda del browser che qualcuno deve ricordarsi di aprire.
Autenticazione	Token di progetto con cinque capacità: push, pull, gestione, lettura e scrittura, con un sottoinsieme di tre capacità per il deploy.	Un login condiviso e una password nel vault del team.
Eventi	12 eventi webhook, firmati con HMAC su timestamp e corpo.	Un riepilogo email notturno.
Formati	Venti formati, letti e scritti in modo nativo. Sette di essi supportano il plurale e un formato che non può esprimere una forma plurale rifiuta la riga invece di inventarne una.	CSV e un convertitore che devi mantenere.
Agenti	Un server MCP che espone 17 strumenti MCP, così un editor può tradurre ciò che manca o eseguire il QA senza uscire dal file.	Copia, incolla e spera.

Transglot

nella pipeline

Dove viene eseguito: Nella CI. L'Azione GitHub crea bozze al push e la CLI fa lo stesso dalla tua shell.
Autenticazione: Token di progetto con cinque capacità: push, pull, gestione, lettura e scrittura, con un sottoinsieme di tre capacità per il deploy.
Eventi: 12 eventi webhook, firmati con HMAC su timestamp e corpo.
Formati: Venti formati, letti e scritti in modo nativo. Sette di essi supportano il plurale e un formato che non può esprimere una forma plurale rifiuta la riga invece di inventarne una.
Agenti: Un server MCP che espone 17 strumenti MCP, così un editor può tradurre ciò che manca o eseguire il QA senza uscire dal file.

Il numero di formati, eventi e strumenti sopra riportato è fissato agli enum da cui proviene tramite test che falliscono quando la copia si discosta.

ciò che puoi chiamare

Cinque modalità di accesso, un unico token di progetto.

Tutte e cinque le modalità si autenticano con lo stesso token con ambito definito, che il piano Free non può generare. Iniziano dal piano Starter.

cli
transglot push e transglot pull
Legge il file che hai già e riscrive al suo interno le bozze delle localizzazioni. Con licenza MIT e pubblicato su npm.
Starter e superiori
action
L’Azione GitHub
transglot/transglot-action crea le bozze al push ed esegue il commit delle localizzazioni nello stesso branch. Con licenza MIT e repository pubblico.
github.com
api
Le API REST
Sessanta richieste al minuto per token. L’endpoint di pull è il metodo supportato per recuperare tutte le stringhe.
/api
mcp
Il server MCP
Il tuo agente chiama direttamente 17 strumenti MCP, quattro dei quali costituiscono il set CRUD del glossario.
Starter e superiori
cdn
Il bundle delle localizzazioni sulla CDN
Pubblica un bundle JSON di localizzazione e leggilo dall’edge in fase di runtime, invece di distribuire una nuova build per una correzione del testo.
Starter e superiori

Non esiste un download browser delle traduzioni, deliberatamente. Le vie di uscita sono l’endpoint di pull, la CLI, il bundle CDN e la sincronizzazione con l’archiviazione file.

FAQs

Ciò che uno sviluppatore verifica prima di scrivere la prima chiamata.

Esiste un’API di traduzione che posso chiamare dal mio codice?

Sì: un'API REST v1, una CLI su npm, un'azione GitHub, un server MCP con 17 strumenti e 12 eventi webhook firmati. Tutti e cinque si autenticano con lo stesso token di progetto con ambito specifico, che il piano gratuito non può generare, quindi iniziano dal piano Starter, a 19 $ al mese.

Cosa offre effettivamente il piano gratuito?

Un progetto, 100.000 parole iniziali (25.000 alla registrazione, 75.000 dopo una verifica telefonica) e 10.000 al mese in seguito, tre posti utente e 15 righe di locale, inclusa quella di origine, che corrispondono a 14 lingue di destinazione. Non è possibile generare un token di progetto, quindi la CLI, l’azione, le API, i webhook e il server MCP sono disponibili a partire dal piano Starter.

Come integro la traduzione nella mia pipeline CI?

Aggiungi l'azione GitHub. Crea le bozze di ogni lingua mappata al push ed esegue il commit nel branch su cui è stato eseguito il workflow, così su un branch di funzionalità le traduzioni arrivano nella pull request per quel branch, insieme alla modifica anziché dopo di essa. La CLI invia e recupera dati da qualsiasi altro runner e, con --wait, esce con codice diverso da zero quando un'esecuzione fallisce, il che evidenzia il passaggio in rosso invece di lasciare passare silenziosamente una riga rifiutata.

Qual è il limite di richieste API?

Sessanta richieste al minuto per token di progetto. Il limite è per token e non per organizzazione, così un job CI rumoroso non può affamare il tuo reader di produzione.

Come vengono firmati i webhook e come posso impedire i replay?

Ogni consegna include un'intestazione timestamp e una firma HMAC calcolata sul timestamp e sul corpo. Pubblichiamo il timestamp in modo che il tuo ricevitore possa applicare qualsiasi finestra di replay desideri; non ne imponiamo una noi.

Quali eventi webhook inviate?

12 eventi webhook: batch.completed, batch.failed, key.created, key.updated, key.deleted, translation.updated, translation.reviewed, language.added, language.removed, glossary.updated, qa.completed e source_drift.repaired. Lo stesso elenco è leggibile tramite GET /v1/webhooks/events, così il tuo codice non deve mai codificarlo manualmente.

Cosa può fare un token di progetto e posso limitarne l'ambito?

Un token dispone di cinque funzionalità: push, pull, manage, read e write, ed esiste un sottoinsieme deploy con tre funzionalità per un job che deve solo spostare file. I token vengono generati per progetto, quindi uno non può accedere a un progetto per cui non è stato creato.

Quali formati di file conservano le forme plurali?

Sette su venti: Android XML, iOS stringsdict, iOS xcstrings, Flutter ARB, gettext PO, CSV e XLSX. Laravel PHP non lo fa e, invece di inventare una forma, il suo codec rifiuta la riga.

Esiste un server MCP per il mio agente di coding?

Sì, con 17 strumenti, così un agente può leggere un progetto, elencare e aggiungere lingue, ottenere e aggiornare una singola traduzione, scaricare e caricare file interi, tradurre ciò che manca, monitorare o annullare un batch, ripetere un'operazione fallita ed eseguire il QA senza uscire dall'editor. Quattro dei diciassette sono gli strumenti del glossario. L'annullamento di un batch restituisce le parole non utilizzate alla tua quota.

Cosa succede quando una traduzione non supera un controllo?

Un segnaposto errato, una forma plurale mancante o un termine del glossario vietato ricevono un tentativo di correzione automatica e i controlli vengono eseguiti nuovamente sul risultato. Se il controllo fallisce ancora, la riga viene rifiutata anziché scritta nel tuo file. Una riga che supera solo il limite di lunghezza viene invece scritta e, dal piano Team, l'approvazione automatica o un'esecuzione QA la segnala per la revisione.

Posso modificare una stringa senza rilasciare una nuova build?

Sul web, sì. Pubblica un bundle di locale sulla CDN dal piano Starter e leggilo in runtime, così una correzione del testo è una pubblicazione invece di un rilascio. Le app native prendono ancora le loro stringhe dai formati di file e richiedono una build.

Come posso recuperare tutte le stringhe?

GET /v1/pull, la CLI, il bundle CDN o la sincronizzazione dell'archiviazione file con S3, Dropbox o Drive. Non è previsto deliberatamente il download delle traduzioni dal browser, quindi pianifica l'uso di uno di questi quattro metodi.

Qualcosa è open source?

La CLI ha licenza MIT ed è pubblicata su npm, e l'azione GitHub ha licenza MIT con un repository pubblico. L'applicazione ospitata stessa, inclusi il motore e i codec dei formati, è privata e nulla su questo sito deve essere interpretato diversamente.