Lys gebeurtenisse

Parameters

Lingara-Versionheaderstringopsioneel

Die API-weergawe waaronder hierdie versoek beantwoord word. Daarsonder kry 'n toegangstoken die weergawe waaraan sy kliënt gekoppel is, en 'n versoek sonder 'n token kry die huidige weergawe. Die weergawe wat nog ontwikkel word, is slegs bereikbaar deur dit hier te noem. 'n Onbekende weergawe gee 400 met kode api_version_unknown. GET /v1/versions lys die weergawes.

cursorquerystringopsioneel

Waarvandaan om voort te gaan: 'n vorige bladsy se next_cursor, of 'n stroomgebeurtenis se id:. 'n Wyser ouer as 30 dae gee 410 met kode cursor_expired.

startquerystringopsioneel

Waar om sonder 'n wyser te begin: latest vir gebeurtenisse van nou af, of oldest vir elke gebeurtenis wat nog bewaar word.

typesqueryarray of stringopsioneel

Slegs hierdie gebeurtenistipes, met kommas geskei. Daarsonder, elke tipe wat jou token se bestekke kan lees.

limitqueryintegeropsioneel

Die meeste gebeurtenisse wat een bladsy teruggee, van 1 tot 100.

Antwoorde

200 'n Bladsy gebeurtenisse en die wyser om van voort te gaan

itemsarray of EventEnvelopeverplig

idstringverplig

typestringverplig

created_atstringverplig

api_versionstringverplig

subjectstringverplig

dataobjectverplig

next_cursorstringverplig

has_morebooleanverplig

Foute

410application/json

api_version_discontinued: hierdie versoek se API-weergawe is gestaak. cursor_expired: die wyser is ouer as 30 dae; begin weer sonder een.

4XXapplication/json

Die versoek is geweier. code sê hoekom, en error sê dit in woorde.

503application/json · text/plain

Die diens is tydelik onbeskikbaar; probeer weer na die aantal sekondes in Retry-After. Tydens onderhoud is die liggaam gewone teks eerder as die foutomhulsel.

5XXapplication/json

Die versoek is geweier. code sê hoekom, en error sê dit in woorde.

codestringverplig

Waarom die versoek geweier is, as 'n stabiele kode om op te vertak: byvoorbeeld insufficient_scope (403), rate_limited (429) en, vir 'n gemeterde kliënt, spend_cap_reached (402) en metered_billing_inactive (402).

errorstringverplig

Voorbeeld

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

Verkies jy 'n biblioteek? Sien die Biblioteke-afdeling.