api.transglot.ai/v1token bearer, un progettoriferimento

Invia un file. Ricevi tutte le lingue.

Un’API REST per tradurre la tua app. Un POST carica il file sorgente, un GET restituisce una localizzazione completata e un token bearer è l’unica autenticazione richiesta. Qualsiasi sistema in grado di comunicare via HTTP può utilizzarla.

in: una chiamata

curl -X POST https://api.transglot.ai/v1/push \

-H "Authorization: Bearer $TRANSGLOT_TOKEN" \

-F "file=@lang/en.json" \

-F "format=laravel_json"

202 accepted · batch queued

out

300,000

parole al mese con Starter, il primo piano che consente di generare un token.

Inizia gratis Vedi la documentazione per sviluppatori

60 richieste al minuto per token · ogni risposta 429 include un header Retry-After · usa token separati per CI e produzione

la console è un client API

Invia, traduci, verifica e recupera, ogni operazione è un endpoint REST.

Ogni riga nell’immagine sottostante corrisponde a una route: invio, verifiche, glossario, batch e recupero, tutte accessibili dal tuo codice con un token di progetto. L’area di prova API nella console esegue live le operazioni di sola lettura sul tuo progetto, così puoi vedere subito una risposta reale.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Carichi un file sorgente
POST/v1/push
Il pannello delle verifiche si compila
POST/v1/qa/run
Blocchi un termine
POST/v1/glossary
La vista batch esegue il polling autonomamente
GET/v1/batches/:id
Recuperi le traduzioni
GET/v1/pull

una route per pannello, 60 al minuto, funzionalità per token · anche l’invio delle tue traduzioni avviene tramite un endpoint

è solo HTTP

Quattro elementi che i team sviluppano per primi.

ognuno è un singolo endpoint e un token di progetto · nessuno richiede un pomeriggio intero

merge gate · un file di workflow

Segnala la pull request come non superata quando una traduzione fallisce.

cron · ogni notte

Traduci le note di rilascio durante la notte, ogni notte.

bot · una sottoscrizione

Pubblica su Slack non appena un batch viene completato.

agent · MCP

Offri a un agente AI gli stessi 17 strumenti che hai tu.

richieste al minuto

per token, non per account, con un’intestazione Retry-After in ogni risposta 429 che indica quanti secondi attendere.

formati file

invia e recupera nel formato già utilizzato dal tuo repository. Plurali e segnaposto vengono preservati in entrambe le direzioni. Specifica il formato con format= in qualsiasi chiamata.

eventi webhook

l’intero catalogo, ciascuno con un payload di esempio nella stessa struttura di una consegna reale. GET /v1/webhooks/events.

strumenti MCP

lo stesso token di progetto, fornito a un runtime dell’agente invece che a curl. npx -y @transglot/mcp.

FAQ

Le domande più frequenti degli sviluppatori prima della prima richiesta.

Come mi autentico all’API Transglot?

Invia un token bearer: Authorization: Bearer $TRANSGLOT_TOKEN. Il token appartiene a un singolo progetto, quindi non è necessario includere l’ID del progetto nel percorso né esiste una chiave a livello di account da proteggere. Puoi creare i token dalla pagina del progetto e ognuno ha le proprie autorizzazioni: push, pull, manage, read, write.

L’API è gratuita?

No. Un token bearer inizia con il piano Starter a 19 $ al mese. La versione gratuita include la console, sufficiente per valutare se il prodotto fa al caso tuo, ma non consente di generare un token. La CLI, l’azione GitHub, i webhook, MCP e il pacchetto di delivery sono tutti accessibili tramite lo stesso token, quindi sono disponibili insieme.

Come carico le stringhe su Transglot?

Esegui POST /v1/push con il file e il suo formato, ad esempio -F "file=@lang/en.json" -F "format=laravel_json". La risposta è 202 e accoda un batch. Vengono tradotte solo le righe effettivamente modificate, quindi inviare un file invariato non comporta costi.

Come posso recuperare le mie traduzioni?

GET /v1/pull, in uno dei 20 formati disponibili, quando vuoi. È l’endpoint utilizzato dalla CLI e quello eseguito live nell’API playground. Non è necessario inviare una richiesta di esportazione né ci sono finestre temporali in cui i dati smettono di essere tuoi.

Qual è il limite di richieste API?

60 richieste al minuto, conteggiate per token anziché per account. Se superi il limite, ricevi un errore 429 con un’intestazione Retry-After che indica quanti secondi attendere; non viene addebitato nulla e nessuna scrittura rimane incompleta. Assegna token separati alla CI e alla produzione, così una build rumorosa non affamerà la tua app.

Quali lingue supporta l’API?

Non esiste un elenco fisso. Il validatore accetta qualsiasi tag BCP-47 riconosciuto da ICU, ovvero 708 locale nella tabella di riferimento, più un fallback strutturale per i tag esterni. Aggiungi una locale al progetto e verrà inclusa nel push successivo.

Quali formati di file posso inviare e scaricare?

Venti: JSON flat e nested, Laravel PHP e JSON, Android XML, iOS .strings, .stringsdict e .xcstrings, Flutter ARB, XLIFF 1.2 e 2.0, gettext .po, YAML, CSV, XLSX, Java properties, RESX, Markdown, Unity CSV e Unreal PO. Sette di essi gestiscono i plurali e il file restituito mantiene la stessa struttura di quello inviato.

Transglot offre webhook?

Sì. Ci sono 12 eventi webhook, tra cui batch.completed, translation.reviewed, qa.completed e source_drift.repaired. Ogni consegna è firmata HMAC con un’intestazione timestamp per la verifica, e GET /v1/webhooks/events restituisce il catalogo con un payload di esempio per ciascuno.

Esiste un server MCP per gli agenti AI?

Sì. npx -y @transglot/mcp espone 17 strumenti tramite il token del tuo progetto, così un assistente può leggere una traduzione, scriverne una, aggiungere una lingua, avviare un'esecuzione, controllare un batch o modificare il glossario. È la stessa API e le stesse autorizzazioni, accessibili da un runtime dell'agente invece che da curl.

Posso eseguirlo in CI?

Sì. L'azione GitHub (transglot/transglot-action@v1) e la CLI avvolgono entrambi questi endpoint. Quando una riga viene rifiutata, transglot push --wait esce con codice 4 e l'azione fa fallire il job per quell'esecuzione. Per bloccare un merge, eseguilo sulle pull request con il suo input commit impostato su none, aggiungi uno step che fallisce quando a un file recuperato manca una chiave e rendi il job un controllo obbligatorio nella protezione dei branch.

Cosa succede quando una traduzione non supera un controllo di qualità?

Quattro gate deterministici leggono ogni riga: segnaposto, plurali, termini del glossario e lunghezza. Un segnaposto errato, una forma plurale mancante o un termine del glossario vietato attivano un tentativo correttivo automatico e, se fallisce ancora, la riga viene rifiutata invece di essere scritta. Una riga che supera solo il limite di lunghezza viene scritta, non rifiutata. GET /v1/batches/:id?include=failures elenca le righe rifiutate e il motivo.

L’API potrebbe mai interrompere la mia integrazione?

No. /v1 aggiunge solo endpoint e campi di risposta; un campo già analizzato non cambia struttura né scompare. Una modifica incompatibile verrebbe rilasciata sotto un nuovo prefisso di versione, attualmente riservato e vuoto. Il changelog dell’API registra ogni rilascio.