Olayları akışla al

Parametreler

Lingara-Versionheaderstringisteğe bağlı

Bu isteğin yanıtlanacağı API sürümü. Belirtilmezse bir erişim token'ı istemcisinin bağlı olduğu sürümü, token içermeyen bir istek ise güncel sürümü alır. Hâlâ geliştirilmekte olan sürüme yalnızca burada adı verilerek ulaşılır. Bilinmeyen bir sürüm 400 ve api_version_unknown koduyla yanıtlanır. GET /v1/versions sürümleri listeler.

Last-Event-IDheaderstringisteğe bağlı

Aldığınız son olayın id: değeri. cursor ve start üzerinde önceliklidir.

cursorquerystringisteğe bağlı

Nereden devam edileceği: önceki bir sayfanın next_cursor değeri ya da bir akış olayının id: değeri. 30 günden eski bir imleç, cursor_expired koduyla 410 yanıtı alır.

startquerystringisteğe bağlı

İmleç olmadan nereden başlanacağı: bundan sonraki olaylar için latest, hâlâ saklanan her olay için oldest.

typesqueryarray of stringisteğe bağlı

Yalnızca virgülle ayrılmış bu olay türleri. Verilmezse, token'ınızın kapsamlarının okuyabildiği her tür.

Yanıtlar

200 Gerçekleştikçe olaylar, done ya da error gelene kadar

Akış olayları text/event-stream

Her 15 saniyede bir keepalive yorumu gönderir.

event EventEnvelope

idstringzorunlu

typestringzorunlu

created_atstringzorunlu

api_versionstringzorunlu

subjectstringzorunlu

dataobjectzorunlu

done Done Akışı sonlandırır

error StreamError Akışı sonlandırır

200 yanıtının içinde gelir. Durum satırı zaten gönderilmiş olduğundan, akış açıldıktan sonraki bir hata bu olay olarak bildirilir.

codestringzorunlu

messagestringzorunlu

plan_idstring | nullisteğe bağlı

Hatalar

410application/json

api_version_discontinued: bu isteğin API sürümü kullanımdan kaldırıldı. cursor_expired: imleç 30 günden eski; imleç olmadan yeniden başlayın.

4XXapplication/json

İstek reddedildi. code nedenini belirtir, error ise bunu sözcüklerle açıklar.

503application/json · text/plain

Hizmet geçici olarak kullanılamıyor; Retry-After içindeki saniye sayısı kadar bekledikten sonra yeniden deneyin. Bakım sırasında gövde, hata zarfı yerine düz metindir.

5XXapplication/json

İstek reddedildi. code nedenini belirtir, error ise bunu sözcüklerle açıklar.

codestringzorunlu

İsteğin neden reddedildiği, dallanmak için kullanılabilecek sabit bir kod olarak: örneğin insufficient_scope (403), rate_limited (429) ve kullanım başına ücretlendirilen bir istemci için spend_cap_reached (402) ile metered_billing_inactive (402).

errorstringzorunlu

Örnek

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

Kütüphane mi tercih edersiniz? Kütüphaneler bölümüne bakın.

Örnek akış

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