Ereignisse streamen

Parameter

Lingara-Versionheaderstringoptional

Die API-Version, unter der diese Anfrage beantwortet wird. Ohne sie erhält ein Zugriffstoken die Version, an die sein Client gebunden ist, und eine Anfrage ohne Token die aktuelle Version. Die Version in Entwicklung ist nur erreichbar, indem man sie hier nennt. Eine unbekannte Version wird mit 400 und dem Code api_version_unknown beantwortet. GET /v1/versions listet die Versionen auf.

Last-Event-IDheaderstringoptional

Die id: des letzten empfangenen Ereignisses. Sie hat Vorrang vor cursor und start.

cursorquerystringoptional

Wo fortgefahren wird: der next_cursor einer früheren Seite oder die id: eines Stream-Ereignisses. Ein Cursor, der älter als 30 Tage ist, wird mit 410 und dem Code cursor_expired beantwortet.

startquerystringoptional

Wo ohne Cursor begonnen wird: latest für Ereignisse ab jetzt oder oldest für jedes noch aufbewahrte Ereignis.

typesqueryarray of stringoptional

Nur diese Ereignistypen, durch Kommas getrennt. Ohne diesen Parameter jeder Typ, den die Scopes Ihres Tokens lesen dürfen.

Antworten

200 Ereignisse, sobald sie eintreten, bis done oder error

Stream-Ereignisse text/event-stream

Sendet alle 15 Sekunden einen Keepalive-Kommentar.

event EventEnvelope

idstringerforderlich

typestringerforderlich

created_atstringerforderlich

api_versionstringerforderlich

subjectstringerforderlich

dataobjecterforderlich

done Done Beendet den Stream

error StreamError Beendet den Stream

Kommt innerhalb der 200-Antwort an. Die Statuszeile wurde bereits gesendet, daher wird ein Fehler nach dem Öffnen des Streams als dieses Ereignis gemeldet.

codestringerforderlich

messagestringerforderlich

plan_idstring | nulloptional

Fehler

410application/json

api_version_discontinued: Die API-Version dieser Anfrage wurde eingestellt. cursor_expired: Der Cursor ist älter als 30 Tage; beginnen Sie ohne ihn neu.

4XXapplication/json

Die Anfrage wurde abgelehnt. code nennt den Grund, und error beschreibt ihn in Worten.

503application/json · text/plain

Der Dienst ist vorübergehend nicht verfügbar; versuche es nach der in Retry-After angegebenen Anzahl Sekunden erneut. Während Wartungsarbeiten ist der Body reiner Text statt des Fehlerumschlags.

5XXapplication/json

Die Anfrage wurde abgelehnt. code nennt den Grund, und error beschreibt ihn in Worten.

codestringerforderlich

Warum die Anfrage abgelehnt wurde, als stabiler Code, nach dem du verzweigen kannst: zum Beispiel insufficient_scope (403), rate_limited (429) und, bei einem nutzungsbasiert abgerechneten Client, spend_cap_reached (402) und metered_billing_inactive (402).

errorstringerforderlich

Beispiel

curl -N "https://api.getlingara.com/v1/events/stream" \
  -H "Authorization: Bearer $LINGARA_TOKEN"

Lieber eine Bibliothek? Siehe den Bereich Bibliotheken.

Beispiel-Stream

id: djEuNzQ0MTIuOTkxLjE3OTAyNDk1NjQ
event: event
data: {"id":"lgr_evt_4f2a9c1e7b3d4e5f8a9b0c1d2e3f4a5b","type":"lesson_plan.ready","created_at":"2026-10-01T09:12:44Z","api_version":"2026-09-equipped-boxfish","subject":"lgr_sub_0f1e2d3c4b5a69788796a5b4c3d2e1f0","data":{"plan_id":"3f1c2a9e-5b7d-4e21-9a0c-6d8e4f2b1a37","status":"complete","title":"At the night market","source_lang":"en","target_lang":"zh","level":2}}

id: djEuNzQ0MzAuMC4xNzkwMjUwNDY0
event: done
data: {}