Senaraikan peristiwa

Parameter

Lingara-Versionheaderstringpilihan

Versi API yang digunakan untuk menjawab permintaan ini. Tanpanya, token akses mendapat versi yang dipautkan kepada kliennya, dan permintaan tanpa token mendapat versi semasa. Versi yang masih dalam pembangunan hanya boleh dicapai dengan menamakannya di sini. Versi yang tidak dikenali dijawab 400 dengan kod api_version_unknown. GET /v1/versions menyenaraikan versi.

cursorquerystringpilihan

Dari mana hendak diteruskan: next_cursor halaman sebelumnya, atau id: peristiwa strim. Kursor yang lebih lama daripada 30 hari dijawab dengan 410 bersama kod cursor_expired.

startquerystringpilihan

Tempat bermula tanpa kursor: latest untuk peristiwa mulai sekarang, atau oldest untuk setiap peristiwa yang masih disimpan.

typesqueryarray of stringpilihan

Hanya jenis peristiwa ini, dipisahkan dengan koma. Tanpanya, setiap jenis yang boleh dibaca oleh skop token anda.

limitqueryintegerpilihan

Bilangan maksimum peristiwa yang dikembalikan oleh satu halaman, dari 1 hingga 100.

Respons

200 Satu halaman peristiwa dan kursor untuk meneruskan

itemsarray of EventEnvelopewajib

idstringwajib

typestringwajib

created_atstringwajib

api_versionstringwajib

subjectstringwajib

dataobjectwajib

next_cursorstringwajib

has_morebooleanwajib

Ralat

410application/json

api_version_discontinued: versi API permintaan ini telah dihentikan. cursor_expired: kursor lebih lama daripada 30 hari; mulakan semula tanpanya.

4XXapplication/json

Permintaan ditolak. code menyatakan sebabnya, dan error menerangkannya dengan perkataan.

503application/json · text/plain

Perkhidmatan tidak tersedia buat sementara waktu; cuba lagi selepas bilangan saat dalam Retry-After. Semasa penyelenggaraan, kandungan ialah teks biasa dan bukan sampul ralat.

5XXapplication/json

Permintaan ditolak. code menyatakan sebabnya, dan error menerangkannya dengan perkataan.

codestringwajib

Sebab permintaan ditolak, sebagai kod stabil untuk dijadikan asas percabangan: contohnya insufficient_scope (403), rate_limited (429) dan, bagi klien bermeter, spend_cap_reached (402) dan metered_billing_inactive (402).

errorstringwajib

Contoh

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

Lebih suka pustaka? Lihat bahagian Pustaka.