added
Il modello deploy-key, dove il bearer token È il progetto. È ciò su cui si basano sia la CLI sia l’azione GitHub.
api v1 · corrente
Il changelog delle API.
Nessuna rimozione.
/v1 aggiunge solo funzionalità. Nuovi endpoint e nuovi campi di risposta vengono introdotti sotto lo stesso prefisso e un campo che già analizzi non cambia mai forma né scompare. Una modifica incompatibile verrebbe rilasciata sotto un nuovo prefisso di versione, che è riservato e attualmente vuoto.
v1/api/v1
l’unico prefisso in uso
l’unico prefisso in uso
5 release
11 modifiche, nessuna incompatibile
la struttura del log
Un solo prefisso di versione, nessuna rimozione.
Tre di questi quattro elementi sono proprietà di questo log stesso. Il quarto è la dimensione del catalogo di webhook servito dall’API.
5
release su /v1, tutte additive
1
prefisso di versione in uso. Il successivo è riservato e vuoto
0
modifiche incompatibili dal lancio dell’API
12
eventi webhook firmati. Fonte: App\Enums\WebhookEvent
datate per release, non per semver
usa i tasti freccia per navigare
2026-07-08
Distribuzione CDN, utilizzo e playground
July 8, 2026 · 4 modifiche
05 / 05
added
/v1/incontext/translations, /screenshots e /suggest alimentano l’editor visuale, con CORS limitato a quel prefisso e nient’altro.
POST /v1/incontext/session scambia una chiave pubblicabile e un Origin con un token di sessione con ambito limitato.
improved
Un’esportazione bilingue ora segnala ciò che non è stato possibile round-trip invece di sostituire silenziosamente il testo sorgente. I campi esistenti restano invariati, ed è proprio questo il punto di inserirlo in un’intestazione.
GET /v1/pull ha acquisito le intestazioni di risposta X-Skipped-Keys e X-Missing-Source-Keys.
added
Inoltre /v1/glossary/import, /export ed /extract, così la base terminologica può essere importata ed esportata senza aprire la console.
CRUD completo della base terminologica tramite API: GET, POST, PUT e DELETE su /v1/glossary.
added
I risultati vengono inseriti nelle righe di traduzione che già recuperi, quindi non è necessario eseguire nuovi polling.
POST /v1/qa/run avvia un controllo di qualità basato su agenti e restituisce l'handle dell'esecuzione.
added
Sottoscrizione per endpoint. L'elenco si trova in App\Enums\WebhookEvent, che oggi contiene dodici casi; fai riferimento all'enum invece che a questa riga.
I webhook firmati emettono eventi per chiavi, traduzioni, lingue, glossari e QA insieme alla coppia batch originale.
improved
La consegna include un conteggio e fino a venti campioni anziché una chiamata per ogni riga modificata. I log di consegna registrano ogni tentativo con l'orario del prossimo retry.
Gli eventi ad alta frequenza come translation.updated vengono raggruppati in una singola consegna per finestra temporale, evitando il sovraccarico degli endpoint durante le modifiche bulk.
added
Restituisce un ETag e una cache di breve durata e rispetta If-None-Match con un 304. La variante immutabile sotto /v{n} è indirizzata al contenuto e ha una cache di un anno.
Una GET pubblica e cacheabile ai margini della rete /v1/cdn/{project}/{locale} serve le tue stringhe pubblicate.
added
Attivala nella CI con POST /v1/cdn/publish e autorizza le letture con una chiave dedicata di sola lettura nell'header X-Transglot-Cdn-Key. Sicura da mettere dietro una CDN di tua scelta.
La pubblicazione promuove le traduzioni correnti a una nuova versione immutabile, manualmente o ad ogni push.
added
Nessun corpo della richiesta viene archiviato. È solo un conteggio e nient'altro.
Ogni chiamata autenticata a /v1 viene conteggiata per token al giorno e visualizzata nell'hub di distribuzione.
improved
Progetto, pull, batch ed esportazione del glossario. Nessuna modifica alla struttura delle richieste o delle risposte per abilitarlo.
L'hub di distribuzione ha aggiunto un playground API che esegue endpoint di sola lettura in tempo reale sul tuo progetto.
registro deprecazioni
Niente sta per essere rimosso.
Una riga per ogni superficie pubblicata, con la release che l'ha introdotta. L'ultima colonna è quella da monitorare: una rimozione apparirebbe lì con una data molto prima che avvenisse.
| Superficie | Rilasciato | Stato | Data di rimozione |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | corrente | nessuna programmata |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | corrente | nessuna programmata |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | corrente | nessuna programmata |
POST /v1/qa/run | June 12, 2026 | corrente | nessuna programmata |
Signed webhook events, twelve typed cases | June 30, 2026 | corrente | nessuna programmata |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | corrente | nessuna programmata |
Una riga non viene mai eliminata da questa tabella. Se una superficie viene ritirata, mantiene la sua riga e acquisisce una data, perché poter pianificare una rimozione è lo scopo stesso della sua pubblicazione.
la promessa di compatibilità
Tre regole su cui puoi costruire.
additivo
Nuovi endpoint e nuovi campi di risposta vengono rilasciati all'interno di /v1. Un campo che già analizzi non cambia struttura e non scompare.
nuovo prefisso
Una modifica incompatibile verrebbe rilasciata sotto un nuovo prefisso di versione piuttosto che all'interno di questo. Tale prefisso è riservato e inutilizzato, e ogni release successiva si basa su v1.
header trasparenti
Quando una richiesta non può restituire completamente qualcosa, lo indica in un header. Sono stati aggiunti X-Skipped-Keys e X-Missing-Source-Keys invece di modificare il corpo della risposta a tua insaputa.
FAQ
Cosa chiedono gli sviluppatori sul versioning e la deprecazione delle API.
L'API Transglot ha versioni?
Sì, tramite prefisso URL. Tutto ciò che è stato pubblicato finora risiede sotto /v1, che è l'unico prefisso in uso. Non ci sono header di versione, né fissaggio per data, né configurazioni necessarie.
Un aggiornamento potrebbe mai interrompere la mia integrazione?
Non all'interno di /v1. Vengono aggiunti nuovi endpoint e nuovi campi di risposta, ma un campo che già analizzi non cambia struttura e non scompare. Se una modifica non può essere effettuata in modo additivo, verrà rilasciata sotto un nuovo prefisso, mentre quello vecchio continuerà a funzionare.
Qualcosa è stato deprecato o rimosso?
Niente, e il registro sopra lo conferma riga per riga. Ogni superficie pubblicata è elencata con la release che l'ha introdotta e una colonna di rimozione che attualmente riporta "nessuna programmata" dall'inizio alla fine.
Quanto preavviso verrebbe dato per una rimozione?
Una rimozione apparirebbe in quel registro con una data molto prima che avvenisse, e la riga resterebbe nella tabella anche successivamente invece di scomparire. Una data contro cui pianificare è l'intero scopo della sua pubblicazione.
Come faccio a sapere quando viene rilasciato qualcosa di nuovo?
Ogni release è datata in questa pagina. Il changelog del prodotto copre tutto il resto che viene rilasciato, e la console mostra un indicatore quando c'è qualcosa che non hai ancora letto.
Perché esiste un changelog separato per l'API?
Perché l'API porta con sé una promessa di compatibilità che una release del prodotto non ha. Uno sviluppatore che verifica se un'integrazione funziona ancora non dovrebbe dover scorrere attraverso nuove funzionalità per scoprirlo.
Come aggiungo l'API al mio piano?
Un token bearer inizia con il piano Starter a $19 al mese. La versione gratuita copre la console ma non consente di generare un token, mentre CLI, GitHub Action, webhook e MCP richiedono tutti lo stesso token.
Dove si trova la documentazione di riferimento per gli endpoint stessi?
Nella pagina API: autenticazione, endpoint, limiti di frequenza, formati di file e catalogo webhook. Questa pagina è solo il registro di ciò che è cambiato e quando.
funziona con ciò che già esegui
41 connettori, già pronti.
il contratto è il prodotto
Costruisci su un'API che non cambia.
L’API è disponibile nei piani Starter e superiori. Il piano gratuito costa 0 $ e include 100.000 parole per iniziare (25.000 al momento dell’iscrizione, 75.000 dopo una verifica telefonica), poi 10.000 al mese, senza API o webhook.