Schnellstart

API-Version 2026-10-affable-towhee

Fünf Schritte von null zu einer gestreamten Vokabelliste: einen Client erstellen, ihn in deine Shell legen, ihn gegen ein Zugriffstoken eintauschen, einen Aufruf ausführen und ein neues Token holen, wenn es abläuft.

1. Einen Client erstellen

Erstelle auf der Seite Integrationen der Lingara-Web-App unter app.getlingara.com/admin im Bereich OAuth-Clients einen Client, der „Vokabeln generieren“ darf (der Scope vocab:generate). Kopiere seine Client-ID und sein Secret. Das Secret wird nur einmal angezeigt.

2. In deine Shell legen

Speichere Client-ID und Secret in den Umgebungsvariablen LINGARA_CLIENT_ID und LINGARA_CLIENT_SECRET, sodass nie ein Secret in einen Befehl geschrieben wird.

export LINGARA_CLIENT_ID="<your client id>"
export LINGARA_CLIENT_SECRET="<your client secret>"

3. Ein Zugriffstoken erhalten

Dieser Befehl tauscht den Client gegen ein Zugriffstoken ein und legt es in LINGARA_TOKEN ab, das jedes Beispiel in dieser Referenz liest. Er benötigt jq und curl 7.76 oder neuer. Scheitert der Austausch, gibt der Befehl den Fehlercode aus (zum Beispiel invalid_client: Prüfe ID und Secret) und lässt LINGARA_TOKEN leer, sodass der nächste Aufruf mit 401 scheitert, bis ein Austausch gelingt. Ohne jq führe den Austausch aus der Anleitung Authentifizierung aus und kopiere access_token von Hand aus der Antwort.

export LINGARA_TOKEN="$(curl -sS --fail-with-body -X POST "https://api.getlingara.com/oauth/token" \
  -u "$LINGARA_CLIENT_ID:$LINGARA_CLIENT_SECRET" \
  -d "grant_type=client_credentials" \
  --data-urlencode "scope=vocab:generate" | jq -r '.access_token // error(.error)')"

4. Eine Vokabelliste erzeugen

Führe diesen Befehl aus. -N schaltet die Pufferung von curl ab, sodass jedes Ereignis ausgegeben wird, sobald es eintrifft.

curl -N -X POST "https://api.getlingara.com/v1/vocab/stream" \
  -H "Authorization: Bearer $LINGARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"level":2,"source_lang":"en","target_lang":"zh","count":8}'

Was du sehen solltest

Ein started-Ereignis mit den Details der Liste, ein item-Ereignis pro Wort, dann done. Deine Wörter werden von diesem Beispiel abweichen.

event: started
data: {"meta":{"level":2,"source_lang":"en","target_lang":"zh","framework":"HSK","count":2,"ai_generated":true}}

event: item
data: {"word":"你好","pronunciation":"nǐ hǎo","translation":"hello","example":{"sentence":"你好，我叫小明。","translation":"Hello, my name is Xiaoming."}}

event: item
data: {"word":"谢谢","pronunciation":"xiè xie","translation":"thank you"}

event: done
data: {}

5. Wenn die Stunde um ist

Der Aufruf antwortet mit 401. Führe Schritt 3 erneut aus. Scheitert Schritt 3 jetzt, hat sich der Client oder sein Secret auf der Seite Integrationen geändert. Ein Programm folgt der Regel aus der Anleitung Authentifizierung: einmal pro 401 erneut tauschen und aufhören, wenn der Austausch scheitert.

Weichen eine Übersetzung und die englische Referenz voneinander ab, ist die englische Referenz maßgeblich.