Sie haben Inhalte in einer Sprache – und Nutzer, die viele lesen. Die API schließt diese Lücke programmgesteuert: Sie senden Text, erhalten ihn übersetzt zurück, und jede Übersetzung läuft durch eine Lokalisierungs-Engine, die Sie einmal konfigurieren. Die Engine wendet bei jedem Aufruf Ihr Glossar, Ihre Markenstimme, Ihre Anweisungen und Ihre Modellauswahl pro Sprache an – damit sich die Ausgabe so liest, wie Ihr Team es festgelegt hat, und nicht so, wie ein generisches Modell es erraten würde.
Damit bleibt nur eine Entscheidung: wie viel Sie auf einmal übersetzen müssen. Übersetzen Sie eine einzelne Sprache mit einer Anfrage und lesen Sie das Ergebnis direkt aus der Antwort aus – oder übergeben Sie der Plattform viele Sprachen und lassen Sie jede davon als unabhängigen Hintergrundjob übersetzen, während Ihre App reaktionsschnell bleibt. Diese Seite erklärt die Basis-URL, genau diese Entscheidung und wohin es als Nächstes geht.
Was diese API voraussetzt
Dies ist die Referenz für programmgesteuertes Übersetzen. Sie setzt voraus, dass Sie sich entschieden haben, aus Ihrem eigenen Code oder Ihrer eigenen Pipeline heraus zu lokalisieren – nicht über das Dashboard – und dass Sie einen API-Schlüssel haben. Neu auf der Plattform? Das Konzept der Lokalisierungs-Engine sollten Sie zuerst verstehen; alles hier baut darauf auf.
Auf dieser Seite
- Basis-URL
- Zwei Wege zu übersetzen
- Asynchron: viele Sprachen als Jobs
- Synchron: eine Anfrage, eine Antwort
- Nächste Schritte
Basis-URL#
Jeder REST-Endpunkt in dieser Referenz läuft über denselben Host:
https://api.lingo.devJede Anfrage enthält außerdem einen Header, X-API-Key. Der Schlüssel ist organisationsweit gültig und wird bei der Erstellung nur einmal angezeigt. Die vollständigen Regeln zum Senden finden Sie unter Authentication; was zurückkommt, wenn eine Anfrage abgelehnt wird, steht unter Errors and status codes.
Zwei Wege zu übersetzen#
Hinter beiden Modi steckt dieselbe Engine mit demselben Glossar und derselben Markenstimme. Der einzige Unterschied: wer auf das Ergebnis wartet.
Ein synchroner Aufruf übersetzt ein Sprachpaar und gibt die übersetzten Daten direkt in der Antwort zurück. Das ist die einfachere Variante – eine Anfrage, eine Antwort, kein Endpunkt auf Ihrer Seite – und die richtige Wahl, wenn Sie nur eine Sprache brauchen und auf einen Roundtrip warten können.
Aber Inhalte gehen selten nur in eine Sprache. Ein Schulungsmodul erscheint in 14 Sprachen; ein CMS-Eintrag wird auf jeden Markt ausgerollt, in dem Sie aktiv sind. Wenn Sie pro Sprache einen synchronen Aufruf auslösen, gehören Ihnen 14 Roundtrips und die Retry-Logik, falls einer fehlschlägt. Warten Sie auf einen einzigen synchronen Aufruf für alle, blockieren Sie auf den langsamsten. Deshalb bietet die API auch einen asynchronen Modus: Sie senden Ihre Inhalte einmal per POST mit den Zielsprachen, erhalten sofort eine 202, und die Plattform übersetzt jede Sprache als unabhängigen Hintergrundjob – inklusive Retries und Fehlerisolation, während Ihre App reaktionsschnell bleibt.
Nutzen Sie async, wenn der Job zu groß, zu langsam oder auf zu viele Sprachen verteilt ist, um darauf zu blockieren. Nutzen Sie sync, wenn ein Sprachpaar in einer Antwort alles ist, was Sie brauchen. Die async-Seiten kommen unten zuerst, weil sie mehr abdecken – aber keine von beiden ist die „eigentliche“ API. Es sind zwei Ausprägungen derselben Engine.
Asynchron: viele Sprachen als Jobs#
Eine Anfrage, alle Sprachen, Ergebnisse sofort nach Fertigstellung. Die async API nimmt eine Übermittlung entgegen, erstellt einen Job pro Zielsprache und liefert jedes Ergebnis in dem Moment, in dem es fertig ist – per Webhook oder WebSocket – ohne dass Ihre App auf irgendetwas davon warten muss.
Synchron: eine Anfrage, eine Antwort#
Wenn Sie ein Sprachpaar brauchen und auf den Roundtrip warten können, rufen Sie einen synchronen Endpunkt auf und lesen das Ergebnis direkt aus der Antwort aus – ohne Webhook-Endpunkt, ohne Polling.
Nächste Schritte#
Für welchen Modus Sie sich auch entscheiden: Die Engine dahinter lässt sich genau auf Ihre Anforderungen abstimmen. Erstellen Sie einen Schlüssel und legen Sie dann fest, was die Engine bei jedem Aufruf tun soll – welches Modell sie pro Sprache auswählt und welche Begriffe sie exakt übersetzen muss.
