이벤트 스트리밍

매개변수

Lingara-Versionheaderstring선택

이 요청에 응답할 API 버전입니다. 지정하지 않으면 액세스 토큰은 해당 클라이언트에 고정된 버전을, 토큰이 없는 요청은 현재 버전을 받습니다. 개발 중인 버전은 여기에서 지정해야만 사용할 수 있습니다. 알 수 없는 버전에는 코드 api_version_unknown과 함께 400으로 응답합니다. GET /v1/versions에서 버전 목록을 확인할 수 있습니다.

Last-Event-IDheaderstring선택

마지막으로 받은 이벤트의 id:. cursor와 start보다 우선합니다.

cursorquerystring선택

이어서 읽을 위치: 이전 페이지의 next_cursor 또는 스트림 이벤트의 id:. 30일보다 오래된 커서는 코드 cursor_expired와 함께 410으로 응답합니다.

startquerystring선택

커서 없이 시작할 위치: 지금부터의 이벤트는 latest, 아직 보관된 모든 이벤트는 oldest.

typesqueryarray of string선택

쉼표로 구분한 이 이벤트 유형만. 생략하면 토큰의 범위로 읽을 수 있는 모든 유형.

응답

200 발생하는 이벤트, done 또는 error까지

스트림 이벤트 text/event-stream

15초마다 keepalive 주석을 보냅니다.

event EventEnvelope

idstring필수

typestring필수

created_atstring필수

api_versionstring필수

subjectstring필수

dataobject필수

done Done 스트림 종료

error StreamError 스트림 종료

200 응답 안에서 도착합니다. 상태 줄이 이미 전송되었으므로 스트림이 열린 뒤의 실패는 이 이벤트로 보고됩니다.

codestring필수

messagestring필수

plan_idstring | null선택

오류

410application/json

api_version_discontinued: 이 요청의 API 버전은 지원이 종료되었습니다. cursor_expired: 커서가 30일보다 오래되었습니다. 커서 없이 다시 시작하세요.

4XXapplication/json

요청이 거부되었습니다. code는 이유를, error는 이를 문장으로 알려 줍니다.

503application/json · text/plain

서비스를 일시적으로 사용할 수 없습니다. Retry-After에 있는 초만큼 기다린 후 다시 시도하세요. 점검 중에는 본문이 오류 엔벨로프가 아닌 일반 텍스트입니다.

5XXapplication/json

요청이 거부되었습니다. code는 이유를, error는 이를 문장으로 알려 줍니다.

codestring필수

요청이 거부된 이유를 분기에 쓸 수 있는 안정적인 코드로 나타냅니다. 예: insufficient_scope(403), rate_limited(429), 사용량 기반 과금 클라이언트의 경우 spend_cap_reached(402)와 metered_billing_inactive(402).

errorstring필수

예시

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

라이브러리가 더 편하신가요? 라이브러리 섹션을 보세요.

스트림 예시

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