Olayları listele

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.

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.

limitqueryintegeristeğe bağlı

Bir sayfanın döndürdüğü en fazla olay sayısı, 1 ile 100 arasında.

Yanıtlar

200 Bir sayfa olay ve devam edilecek imleç

itemsarray of EventEnvelopezorunlu

idstringzorunlu

typestringzorunlu

created_atstringzorunlu

api_versionstringzorunlu

subjectstringzorunlu

dataobjectzorunlu

next_cursorstringzorunlu

has_morebooleanzorunlu

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 "https://api.getlingara.com/v1/events" \
  -H "Authorization: Bearer $LINGARA_TOKEN"

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