Ilista ang mga event

Mga parameter

Lingara-Versionheaderstringopsyonal

Ang bersyon ng API na gagamitin sa pagsagot sa kahilingang ito. Kung wala ito, makukuha ng access token ang bersyong naka-pin sa client nito, at makukuha ng kahilingang walang token ang kasalukuyang bersyon. Maaabot lang ang bersyong dine-develop pa sa pamamagitan ng pagpangalan dito. Ang hindi kilalang bersyon ay sinasagot ng 400 na may code na api_version_unknown. Inililista ng GET /v1/versions ang mga bersyon.

cursorquerystringopsyonal

Kung saan magpapatuloy: ang next_cursor ng naunang pahina, o ang id: ng isang event sa stream. Ang cursor na mas luma sa 30 araw ay sinasagot ng 410 na may code na cursor_expired.

startquerystringopsyonal

Kung saan magsisimula nang walang cursor: latest para sa mga event mula ngayon, o oldest para sa bawat event na nakatago pa.

typesqueryarray of stringopsyonal

Ang mga uri ng event na ito lamang, pinaghihiwalay ng kuwit. Kung wala ito, bawat uri na mababasa ng mga scope ng iyong token.

limitqueryintegeropsyonal

Ang pinakamaraming event na ibinabalik ng isang pahina, mula 1 hanggang 100.

Mga tugon

200 Isang pahina ng mga event at ang cursor na pagpapatuloy

itemsarray of EventEnvelopekailangan

idstringkailangan

typestringkailangan

created_atstringkailangan

api_versionstringkailangan

subjectstringkailangan

dataobjectkailangan

next_cursorstringkailangan

has_morebooleankailangan

Mga error

410application/json

api_version_discontinued: itinigil na ang bersyon ng API ng request na ito. cursor_expired: mas luma sa 30 araw ang cursor; magsimula muli nang wala ito.

4XXapplication/json

Tinanggihan ang kahilingan. Sinasabi ng code kung bakit, at ipinapaliwanag ito ng error sa mga salita.

503application/json · text/plain

Pansamantalang hindi available ang serbisyo; subukang muli pagkatapos ng bilang ng segundong nasa Retry-After. Habang may maintenance, plain text ang body sa halip na ang error envelope.

5XXapplication/json

Tinanggihan ang kahilingan. Sinasabi ng code kung bakit, at ipinapaliwanag ito ng error sa mga salita.

codestringkailangan

Kung bakit tinanggihan ang request, bilang isang matatag na code na mapagbabatayan ng iyong programa: halimbawa insufficient_scope (403), rate_limited (429) at, para sa isang metered client, spend_cap_reached (402) at metered_billing_inactive (402).

errorstringkailangan

Halimbawa

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

Mas gusto ang library? Tingnan ang seksyong Mga library.