Transmitir eventos

Versión de la API 2026-10-affable-towhee

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

Envía cada evento que tu cliente puede ver en cuanto ocurre. El flujo termina con done tras 15 minutos, o con error; vuelve a conectar con el último id: en Last-Event-ID para continuar sin huecos.

Ámbitos events:read

Parámetros

Lingara-Versionheaderstringopcional: La versión de la API con la que se responde a esta solicitud. Sin ella, un token de acceso recibe la versión a la que está vinculado su cliente, y una solicitud sin token recibe la versión actual. La versión aún en desarrollo solo se alcanza nombrándola aquí. Una versión desconocida responde 400 con el código api_version_unknown. GET /v1/versions enumera las versiones.
Last-Event-IDheaderstringopcional: El id: del último evento que recibiste. Tiene prioridad sobre cursor y start.
cursorquerystringopcional: Desde dónde continuar: el next_cursor de una página anterior o el id: de un evento del flujo. Un cursor de más de 30 días responde 410 con el código cursor_expired.
startquerystringopcional: Dónde empezar sin cursor: latest para los eventos a partir de ahora, u oldest para todos los eventos que aún se conservan.
typesqueryarray of stringopcional: Solo estos tipos de evento, separados por comas. Sin él, todos los tipos que los ámbitos de tu token pueden leer.

Respuestas

200 Eventos a medida que ocurren, hasta done o error

Eventos del flujo `text/event-stream`

Envía un comentario keepalive cada 15 segundos.

event EventEnvelope

idstringobligatorio
typestringobligatorio
created_atstringobligatorio
api_versionstringobligatorio
subjectstringobligatorio
dataobjectobligatorio

done Done Termina el flujo

error StreamError Termina el flujo

Llega dentro de la respuesta 200. La línea de estado ya se ha enviado, así que un fallo después de abrirse el flujo se notifica como este evento.

codestringobligatorio
messagestringobligatorio
plan_idstring | nullopcional

Errores

410application/json: api_version_discontinued: la versión de la API de esta solicitud se ha retirado. cursor_expired: el cursor tiene más de 30 días; vuelve a empezar sin él.
4XXapplication/json: La solicitud fue rechazada. code indica el motivo y error lo explica con palabras.
503application/json · text/plain: El servicio no está disponible temporalmente; vuelve a intentarlo tras el número de segundos indicado en Retry-After. Durante el mantenimiento, el cuerpo es texto sin formato en lugar del sobre de error.
5XXapplication/json: La solicitud fue rechazada. code indica el motivo y error lo explica con palabras.

codestringobligatorio: Por qué se rechazó la solicitud, como un código estable con el que ramificar: por ejemplo insufficient_scope (403), rate_limited (429) y, para un cliente con facturación por uso, spend_cap_reached (402) y metered_billing_inactive (402).
errorstringobligatorio

Ejemplo

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

¿Prefieres una biblioteca? Consulta la sección Bibliotecas.

Ejemplo de flujo

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

Si una traducción y la referencia en inglés difieren, prevalece la referencia en inglés.