Diffuser les événements

Version de l'API 2026-10-affable-towhee

get https://api.getlingara.com/v1/events/stream

Envoie chaque événement que votre client peut voir dès qu'il se produit. Le flux se termine par done après 15 minutes, ou par error ; reconnectez-vous avec le dernier id: dans Last-Event-ID pour continuer sans interruption.

Portées events:read

Paramètres

Lingara-Versionheaderstringfacultatif: La version de l'API sous laquelle traiter cette requête. Sans elle, un jeton d'accès obtient la version à laquelle son client est rattaché, et une requête sans jeton obtient la version actuelle. La version encore en développement ne s'atteint qu'en la nommant ici. Une version inconnue répond 400 avec le code api_version_unknown. GET /v1/versions liste les versions.
Last-Event-IDheaderstringfacultatif: L'id: du dernier événement reçu. Il a priorité sur cursor et start.
cursorquerystringfacultatif: Où reprendre : le next_cursor d'une page précédente, ou l'id: d'un événement du flux. Un curseur de plus de 30 jours reçoit 410 avec le code cursor_expired.
startquerystringfacultatif: Où commencer sans curseur : latest pour les événements à partir de maintenant, ou oldest pour tous les événements encore conservés.
typesqueryarray of stringfacultatif: Uniquement ces types d'événements, séparés par des virgules. Sans ce paramètre, tous les types que les portées de votre jeton peuvent lire.

Réponses

200 Les événements au fil de l'eau, jusqu'à done ou error

Événements du flux `text/event-stream`

Envoie un commentaire keepalive toutes les 15 secondes.

event EventEnvelope

idstringobligatoire
typestringobligatoire
created_atstringobligatoire
api_versionstringobligatoire
subjectstringobligatoire
dataobjectobligatoire

done Done Termine le flux

error StreamError Termine le flux

Arrive dans la réponse 200. La ligne d'état a déjà été envoyée, donc un échec survenu après l'ouverture du flux est signalé par cet événement.

codestringobligatoire
messagestringobligatoire
plan_idstring | nullfacultatif

Erreurs

410application/json: api_version_discontinued : la version de l'API de cette requête a été retirée. cursor_expired : le curseur a plus de 30 jours ; recommencez sans curseur.
4XXapplication/json: La requête a été refusée. code indique pourquoi, et error l'explique en toutes lettres.
503application/json · text/plain: Le service est temporairement indisponible ; réessayez après le nombre de secondes indiqué dans Retry-After. Pendant la maintenance, le corps est du texte brut plutôt que l'enveloppe d'erreur.
5XXapplication/json: La requête a été refusée. code indique pourquoi, et error l'explique en toutes lettres.

codestringobligatoire: Pourquoi la requête a été refusée, sous forme de code stable sur lequel brancher votre logique : par exemple insufficient_scope (403), rate_limited (429) et, pour un client facturé à l'usage, spend_cap_reached (402) et metered_billing_inactive (402).
errorstringobligatoire

Exemple

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

Vous préférez une bibliothèque ? Consultez la section Bibliothèques.

Exemple de flux

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: {}

En cas de divergence entre une traduction et la référence en anglais, la référence en anglais fait foi.