added
Das Deploy-Key-Modell, bei dem das Bearer-Token DAS Projekt ist. Darauf basieren sowohl die CLI als auch die GitHub Action.
API v1 · aktuell
Das API-Änderungsprotokoll.
Nichts wurde entfernt.
/v1 wird nur erweitert. Neue Endpunkte und neue Antwortfelder kommen im gleichen Präfix hinzu, und ein Feld, das Sie bereits parsen, ändert weder seine Struktur noch verschwindet es. Eine inkompatible Änderung würde unter einem neuen Versionspräfix veröffentlicht werden, das reserviert und noch leer ist.
v1/api/v1
das einzige verwendete Präfix
das einzige verwendete Präfix
5 Releases
11 Änderungen, keine davon inkompatibel
die Struktur des Protokolls
Ein Versionspräfix, keine Entfernungen.
Drei dieser vier Punkte sind Eigenschaften dieses Protokolls selbst. Der vierte ist die Größe des Webhook-Katalogs, den die API bereitstellt.
5
Releases auf /v1, alle rein additiv
1
Verwendetes Versionspräfix. Das nächste ist reserviert und leer
0
Inkompatible Änderungen seit Veröffentlichung der API
12
Signierte Webhook-Ereignisse. Quelle: App\Enums\WebhookEvent
nach Release datiert, nicht nach Semver
Pfeiltasten zum Navigieren verwenden
2026-07-08
CDN-Bereitstellung, Nutzung und Playground
July 8, 2026 · 4 Änderungen
05 / 05
added
/v1/incontext/translations, /screenshots und /suggest steuern den visuellen Editor, wobei CORS auf dieses Präfix beschränkt ist und nichts anderes.
POST /v1/incontext/session tauscht einen veröffentlichbaren Schlüssel und einen Origin gegen ein sitzungsspezifisches Token aus.
improved
Ein zweisprachiger Export meldet nun, was nicht rundlaufend verarbeitet werden konnte, anstatt stillschweigend den Quelltext zu ersetzen. Vorhandene Felder bleiben unverändert – genau darum geht es bei der Auslagerung in einen Header.
GET /v1/pull erhielt die Antwortheader X-Skipped-Keys und X-Missing-Source-Keys.
added
Plus /v1/glossary/import, /export und /extract, sodass eine Termbasis ohne Öffnen der Konsole importiert und exportiert werden kann.
Vollständige CRUD-Verwaltung der Terminologiebasis über die API: GET, POST, PUT und DELETE auf /v1/glossary.
added
Ergebnisse werden in den bereits abgerufenen Übersetzungszeilen angezeigt, sodass nichts Neues abgefragt werden muss.
POST /v1/qa/run löst einen agentenbasierten Qualitätscheck aus und gibt das Run-Handle zurück.
added
Abonnement pro Endpunkt. Die Liste selbst befindet sich in App\Enums\WebhookEvent, das heute zwölf Fälle enthält; zählen Sie das Enum statt dieser Zeile.
Signierte Webhooks senden Schlüssel-, Übersetzungs-, Sprach-, Glossar- und QA-Ereignisse zusammen mit dem ursprünglichen Batch-Paar.
improved
Die Lieferung enthält eine Anzahl und bis zu zwanzig Beispiele statt eines Aufrufs pro geänderter Zeile. Lieferprotokolle erfassen jeden Versuch mit dem Zeitpunkt des nächsten Wiederholungsversuchs.
Häufige Ereignisse wie translation.updated werden zu einer Lieferung pro Zeitfenster zusammengefasst, sodass Massenbearbeitungen einen Endpunkt nie überfluten.
added
Es gibt ein ETag und einen kurzlebigen Cache zurück und berücksichtigt If-None-Match mit einem 304-Status. Das unveränderliche Gegenstück unter /v{n} ist inhaltsadressiert und wird für ein Jahr gecacht.
Ein öffentliches, edge-cache-fähiges GET /v1/cdn/{project}/{locale} stellt Ihre veröffentlichten Strings bereit.
added
Lösen Sie es in der CI mit POST /v1/cdn/publish aus und autorisieren Sie Lesezugriffe mit einem dedizierten Nur-Lese-Schlüssel im Header X-Transglot-Cdn-Key. Sicher hinter einem eigenen CDN platzierbar.
Beim Veröffentlichen werden die aktuellen Übersetzungen manuell oder bei jedem Push in eine neue unveränderliche Version übernommen.
added
Keine Request-Bodies werden gespeichert. Es handelt sich nur um eine Zählung.
Jeder authentifizierte /v1-Aufruf wird täglich pro Token gezählt und im Deploy-Hub angezeigt.
improved
Projekt, Pull, Batches und Glossar-Export. Keine Request- oder Response-Struktur wurde geändert, um dies zu ermöglichen.
Der Deploy-Hub erhielt einen API-Playground, der Nur-Lese-Endpunkte live gegen Ihr Projekt ausführt.
Deprecation-Register
Nichts wird entfernt.
Eine Zeile pro veröffentlichter Oberfläche, mit der Release-Version, in der sie eingeführt wurde. Die letzte Spalte ist diejenige, die Sie beobachten sollten: Eine Entfernung würde dort lange vorher mit einem Datum erscheinen.
| Oberfläche | Veröffentlicht | Status | Entfernungsdatum |
|---|---|---|---|
GET /v1/project · /pull · POST /push · /translate · GET /batches | April 2, 2026 | aktuell | keine geplant |
POST /v1/incontext/session · /translations · /screenshots · /suggest | May 20, 2026 | aktuell | keine geplant |
GET, POST, PUT, DELETE /v1/glossary · /import · /export · /extract | June 12, 2026 | aktuell | keine geplant |
POST /v1/qa/run | June 12, 2026 | aktuell | keine geplant |
Signed webhook events, twelve typed cases | June 30, 2026 | aktuell | keine geplant |
GET /v1/cdn/{project}/{locale} · POST /v1/cdn/publish | July 8, 2026 | aktuell | keine geplant |
Eine Zeile wird niemals aus dieser Tabelle gelöscht. Wenn eine Oberfläche eingestellt wird, behält sie ihre Zeile und erhält ein Datum, denn eine planbare Entfernung ist der eigentliche Zweck dieser Veröffentlichung.
das Kompatibilitätsversprechen
Drei Regeln auf dem Sie aufbauen können.
Additiv
Neue Endpunkte und neue Antwortfelder werden innerhalb von /v1 bereitgestellt. Ein Feld, das Sie bereits parsen, ändert seine Struktur nicht und verschwindet nicht.
Neues Präfix
Eine inkompatible Änderung würde unter einem neuen Versionspräfix statt innerhalb dieses bereitgestellt werden. Dieses Präfix ist reserviert und ungenutzt, und jede Veröffentlichung darüber hinaus wurde auf v1 veröffentlicht.
Ehrliche Header
Wenn ein Pull-Vorgang etwas nicht vollständig verarbeiten kann, wird dies in einem Header angegeben. X-Skipped-Keys und X-Missing-Source-Keys wurden hinzugefügt, anstatt den Body unerwartet zu ändern.
FAQs
Was Entwickler zur API-Versionierung und -Abschaltung fragen.
Ist die Transglot-API versioniert?
Ja, über URL-Präfixe. Alles, was bisher veröffentlicht wurde, befindet sich unter /v1, dem einzigen derzeit genutzten Präfix. Es gibt keinen Versionsheader, keine Datumsbindung und nichts zu konfigurieren.
Kann ein Update meine Integration jemals beschädigen?
Nicht innerhalb von /v1. Neue Endpunkte und neue Antwortfelder werden hinzugefügt, aber ein Feld, das Sie bereits parsen, ändert seine Struktur nicht und verschwindet nicht. Wenn eine Änderung nicht additiv erfolgen kann, wird sie unter einem neuen Präfix bereitgestellt, und das alte funktioniert weiterhin.
Wurde etwas abgeschaltet oder entfernt?
Nein, und das obige Register führt dies zeilenweise auf. Jede veröffentlichte Oberfläche ist mit der Veröffentlichung, die sie eingeführt hat, und einer Spalte „Entfernung“ aufgeführt, die durchgehend „keine geplant“ lautet.
Wie viel Vorlaufzeit gibt es bei einer Entfernung?
Eine Entfernung würde in diesem Register lange vorher mit einem Datum erscheinen, und die Zeile würde danach in der Tabelle verbleiben, statt zu verschwinden. Ein Datum, auf das Sie sich planen können, ist der eigentliche Zweck dieser Veröffentlichung.
Woher weiß ich, wenn etwas Neues veröffentlicht wird?
Jede Veröffentlichung ist auf dieser Seite datiert. Das Produkt-Changelog deckt alles Weitere ab, was veröffentlicht wird, und die Konsole zeigt einen Marker an, wenn es etwas gibt, das Sie noch nicht gelesen haben.
Warum gibt es ein separates Changelog für die API?
Weil die API ein Kompatibilitätsversprechen trägt, das eine Produktveröffentlichung nicht hat. Ein Entwickler, der prüft, ob eine Integration noch funktioniert, sollte nicht erst durch Feature-Arbeiten scrollen müssen, um das herauszufinden.
Wie füge ich die API meinem Plan hinzu?
Ein Bearer-Token beginnt im Starter-Plan bei 19 $ pro Monat. Kostenlos deckt die Konsole ab, kann aber kein Token erstellen, und die CLI, die GitHub Action, Webhooks und MCP liegen alle hinter diesem selben Token.
Wo finde ich die Referenz für die Endpunkte selbst?
Auf der API-Seite: Authentifizierung, die Endpunkte, das Rate-Limit, die Dateiformate und der Webhook-Katalog. Diese Seite ist nur die Aufzeichnung dessen, was sich wann geändert hat.
funktioniert mit dem, was Sie bereits betreiben
41 Konnektoren, bereits integriert.
Der Vertrag ist das Produkt
Bauen Sie auf einer API die stabil bleibt.
Die API ist ab dem Starter-Tarif verfügbar. Der Free-Tarif kostet 0 $ und bietet zum Start 100.000 Wörter (25.000 bei der Registrierung, 75.000 nach einer Telefonverifizierung), danach 10.000 pro Monat, ohne API oder Webhooks.