api.transglot.ai/v1Bearer-Token, ein ProjektReferenz

Datei hochladen. Alle Sprachen zurückerhalten.

Eine REST-API zur Übersetzung Ihrer App. Ein POST lädt die Quelldatei hoch, ein GET liefert die fertige Locale zurück und ein Bearer-Token ist die gesamte Authentifizierung. Alles, was HTTP spricht, kann sie steuern.

in: ein Aufruf

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

Wörter pro Monat im Starter-Tarif, der erste Tarif, der ein Token erstellen kann.

Kostenlos starten Entwickleroberfläche ansehen

60 Anfragen pro Minute pro Token · jede 429-Antwort enthält einen Retry-After-Header · verwenden Sie separate Tokens für CI und Produktion

die Konsole ist ein API-Client

Hochladen, übersetzen, prüfen und abrufen, jeder Schritt ein REST-Endpunkt.

Jede Zeile in der Abbildung unten hat eine Route dahinter: Hochladen, Prüfungen, Glossar, Batches und Abruf – alles erreichbar von Ihrem eigenen Code aus mit einem Projekt-Token. Die API-Sandbox in der Konsole führt die schreibgeschützten Endpunkte live gegen Ihr Projekt aus, sodass Sie zuerst eine echte Antwort sehen.

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

Sie laden eine Quelldatei hoch
POST/v1/push
Das Prüfungsfeld wird ausgefüllt
POST/v1/qa/run
Sie sperren einen Begriff
POST/v1/glossary
Die Batch-Ansicht pollt sich selbst
GET/v1/batches/:id
Sie laden die Übersetzungen herunter
GET/v1/pull

eine Route pro Panel, 60 pro Minute, Funktionen pro Token · das Herunterladen Ihrer Übersetzungen ist ebenfalls ein Endpunkt

es ist nur HTTP

Vier Dinge, die Teams zuerst bauen.

jedes ist ein einzelner Endpunkt und ein Projekt-Token · keines davon dauert einen Nachmittag

Merge-Gate · eine Workflow-Datei

Pull-Request rot markieren, wenn eine Übersetzung fehlschlägt.

Cron · nächtlich

Release Notes über Nacht übersetzen, jede Nacht.

Bot · ein Abonnement

Posten Sie in Slack, sobald ein Batch abgeschlossen ist.

Agent · MCP

Geben Sie einem KI-Agenten dieselben 17 Tools wie Ihnen.

Anfragen pro Minute

Pro Token, nicht pro Konto, mit einem Retry-After-Header bei jedem 429, der angibt, wie viele Sekunden gewartet werden muss.

Dateiformate

Verwenden Sie das Format, das Ihr Repository bereits nutzt. Plurale und Platzhalter bleiben in beide Richtungen erhalten. Geben Sie es mit format= in jedem Aufruf an.

Webhook-Ereignisse

Der gesamte Katalog, jeder mit einer Beispiel-Nutzlast in der exakten Form einer echten Zustellung. GET /v1/webhooks/events.

MCP-Tools

Dasselbe Projekt-Token, übergeben an eine Agent-Laufzeitumgebung statt an curl. npx -y @transglot/mcp.

FAQs

Was Entwickler vor der ersten Anfrage wissen möchten.

Wie authentifiziere ich mich bei der Transglot-API?

Senden Sie ein Bearer-Token: Authorization: Bearer $TRANSGLOT_TOKEN. Das Token gehört zu einem Projekt, daher gibt es keine Projekt-ID im Pfad und keinen kontoweiten Schlüssel, der kompromittiert werden könnte. Sie erstellen Tokens auf der Projektseite und jedes hat eigene Berechtigungen: Push, Pull, Verwalten, Lesen, Schreiben.

Ist die API kostenlos?

Nein. Ein Bearer-Token beginnt im Starter-Plan bei 19 $ pro Monat. Kostenlos ist die Konsole, was ausreicht, um zu sehen, ob das Produkt passt, aber sie kann kein Token erstellen. Die CLI, die GitHub Action, Webhooks, MCP und das Delivery-Bundle laufen alle über dasselbe Token, sodass sie gemeinsam verfügbar sind.

Wie lade ich Strings zu Transglot hoch?

POST /v1/push mit der Datei und ihrem Format, z. B. -F "file=@lang/en.json" -F "format=laravel_json". Die Antwort ist 202 und stellt einen Batch in die Warteschlange. Nur tatsächlich geänderte Zeilen werden übersetzt, sodass das Hochladen einer unveränderten Datei nichts kostet.

Wie erhalte ich meine Übersetzungen zurück?

GET /v1/pull, in jedem der 20 Formate, wann immer Sie möchten. Es ist der Endpunkt, den die CLI umschließt, und der, den die API-Sandbox live ausführt. Es gibt keine Exportanfrage als Datei und kein Zeitfenster, in dem die Daten nicht mehr Ihnen gehören.

Was ist das API-Ratenlimit?

60 Anfragen pro Minute, gezählt pro Token statt pro Konto. Darüber hinaus erhalten Sie einen 429 mit einem Retry-After-Header, der angibt, wie viele Sekunden gewartet werden muss, und es wird nichts berechnet oder halb geschrieben. Geben Sie CI und Produktion separate Tokens, damit ein lauter Build Ihre App nicht aushungert.

Welche Sprachen unterstützt die API?

Es gibt keine feste Liste. Der Validator akzeptiert jeden von ICU erkannten BCP-47-Tag, was 708 Locales in der Tabelle entspricht, gegen die geprüft wird, plus einen strukturellen Fallback für Tags außerhalb davon. Fügen Sie dem Projekt ein Locale hinzu, und der nächste Push enthält es.

Welche Dateiformate kann ich pushen und pullen?

Zwanzig: JSON flach und verschachtelt, Laravel PHP und JSON, Android XML, iOS .strings, .stringsdict und .xcstrings, Flutter ARB, XLIFF 1.2 und 2.0, gettext .po, YAML, CSV, XLSX, Java Properties, RESX, Markdown, Unity CSV und Unreal PO. Sieben davon unterstützen Plurale, und die Datei kommt in der gleichen Struktur zurück, in der sie gesendet wurde.

Hat Transglot Webhooks?

Ja. Es gibt 12 Webhook-Ereignisse, darunter batch.completed, translation.reviewed, qa.completed und source_drift.repaired. Jede Zustellung ist mit einem Zeitstempel-Header HMAC-signiert, sodass Sie sie verifizieren können, und GET /v1/webhooks/events gibt den Katalog mit einer Beispiel-Nutzlast für jedes Ereignis zurück.

Gibt es einen MCP-Server für KI-Agenten?

Ja. npx -y @transglot/mcp stellt 17 Tools über Ihr Projekt-Token bereit, sodass ein Assistent eine Übersetzung lesen, schreiben, eine Sprache hinzufügen, einen Lauf starten, einen Batch prüfen oder das Glossar bearbeiten kann. Es ist dieselbe API und dieselben Berechtigungen, nur über eine Agenten-Laufzeitumgebung statt über curl.

Kann ich es in der CI ausführen?

Ja. Die GitHub Action (transglot/transglot-action@v1) und die CLI kapseln diese Endpunkte. Wenn eine Zeile abgelehnt wird, beendet transglot push --wait den Vorgang mit Exit-Code 4 und die Action schlägt für diesen Lauf fehl. Um einen Merge zu stoppen, führen Sie ihn bei Pull Requests aus, setzen Sie die Commit-Eingabe auf none, fügen Sie einen Schritt hinzu, der fehlschlägt, wenn einer gezogenen Datei ein Schlüssel fehlt, und machen Sie den Job zu einer erforderlichen Prüfung in der Branch-Protection.

Was passiert, wenn eine Übersetzung eine Qualitätsprüfung nicht besteht?

Vier deterministische Gates prüfen jede Zeile: Platzhalter, Pluralformen, Glossarbegriffe und Länge. Ein fehlerhafter Platzhalter, eine fehlende Pluralform oder ein verbotener Glossarbegriff löst einen automatischen Korrekturversuch aus; schlägt dieser erneut fehl, wird die Zeile abgelehnt statt geschrieben. Eine Zeile, die nur die Längengrenze überschreitet, wird geschrieben, nicht abgelehnt. GET /v1/batches/:id?include=failures listet die abgelehnten Zeilen und die Gründe dafür auf.

Wird die API meine Integration jemals brechen?

Nein. /v1 erhält nur neue Endpunkte und Antwortfelder; ein Feld, das Sie bereits parsen, ändert weder seine Struktur noch verschwindet es. Eine breaking change würde unter einem neuen Versionspräfix veröffentlicht, das reserviert ist und derzeit noch leer ist. Das API-Changelog dokumentiert jede Veröffentlichung.

funktioniert mit dem, was Sie bereits betreiben