Tiririsha matukio

Vigezo

Lingara-Versionheaderstringsi lazima

Toleo la API la kutumia kujibu ombi hili. Bila hilo, tokeni ya ufikiaji hupata toleo ambalo mteja wake ameunganishwa nalo, na ombi lisilo na tokeni hupata toleo la sasa. Toleo ambalo bado linaendelezwa linafikiwa tu kwa kulitaja hapa. Toleo lisilojulikana hujibiwa 400 pamoja na msimbo api_version_unknown. GET /v1/versions huorodhesha matoleo.

Last-Event-IDheaderstringsi lazima

id: ya tukio la mwisho ulilopokea. Inapewa kipaumbele kuliko cursor na start.

cursorquerystringsi lazima

Mahali pa kuendelea: next_cursor ya ukurasa wa awali, au id: ya tukio la mtiririko. Kiashiria cha zaidi ya siku 30 hujibiwa 410 na msimbo cursor_expired.

startquerystringsi lazima

Mahali pa kuanzia bila kiashiria: latest kwa matukio kuanzia sasa, au oldest kwa kila tukio ambalo bado limehifadhiwa.

typesqueryarray of stringsi lazima

Aina hizi za matukio pekee, zikitenganishwa kwa koma. Bila hiki, kila aina ambayo mawanda ya tokeni yako yanaweza kusoma.

Majibu

200 Matukio yanapotokea, hadi done au error

Matukio ya mtiririko text/event-stream

Hutuma maoni ya keepalive kila sekunde 15.

event EventEnvelope

idstringinahitajika

typestringinahitajika

created_atstringinahitajika

api_versionstringinahitajika

subjectstringinahitajika

dataobjectinahitajika

done Done Humaliza mtiririko

error StreamError Humaliza mtiririko

Hufika ndani ya jibu la 200. Mstari wa hali umeshatumwa, kwa hivyo hitilafu baada ya mtiririko kufunguka huripotiwa kama tukio hili.

codestringinahitajika

messagestringinahitajika

plan_idstring | nullsi lazima

Hitilafu

410application/json

api_version_discontinued: toleo la API la ombi hili limesitishwa. cursor_expired: kiashiria kina zaidi ya siku 30; anza upya bila hicho.

4XXapplication/json

Ombi limekataliwa. code inaeleza sababu, na error inaieleza kwa maneno.

503application/json · text/plain

Huduma haipatikani kwa muda; jaribu tena baada ya idadi ya sekunde zilizo katika Retry-After. Wakati wa matengenezo, mwili wa jibu ni maandishi ya kawaida badala ya bahasha ya hitilafu.

5XXapplication/json

Ombi limekataliwa. code inaeleza sababu, na error inaieleza kwa maneno.

codestringinahitajika

Sababu ya ombi kukataliwa, kama msimbo thabiti wa kufanyia maamuzi: kwa mfano insufficient_scope (403), rate_limited (429) na, kwa mteja anayetozwa kwa matumizi, spend_cap_reached (402) na metered_billing_inactive (402).

errorstringinahitajika

Mfano

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

Unapendelea maktaba? Tazama sehemu ya Maktaba.

Mfano wa mtiririko

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