列出事件

參數

Lingara-Versionheaderstring選填

回應這隻請求所用个 API 版本。無這隻个話，存取權杖會用佢个用戶端綁定个版本，無權杖个請求會用這下个版本。還在開發个版本，淨係在這位講明正用得到。無認識个版本會回 400，代碼係 api_version_unknown。GET /v1/versions 會列出所有版本。

cursorquerystring選填

對哪位繼續：前一頁个 next_cursor，或者串流事件个 id:。超過 30 日个游標會回 410，代碼係 cursor_expired。

startquerystring選填

無游標个時節對哪位開始：latest 係對這下開始个事件，oldest 係還保留个所有事件。

typesqueryarray of string選填

淨愛這兜事件類型，用逗號分開。無這隻參數，就係你个權杖範圍讀得到个所有類型。

limitqueryinteger選填

一頁最多傳回幾多隻事件，對 1 到 100。

回應

200 一頁事件，同繼續用个游標

itemsarray of EventEnvelope必填

idstring必填

typestring必填

created_atstring必填

api_versionstring必填

subjectstring必填

dataobject必填

next_cursorstring必填

has_moreboolean必填

錯誤

410application/json

api_version_discontinued：這隻請求个 API 版本已經停用。cursor_expired：游標超過 30 日；毋使游標重新開始。

4XXapplication/json

請求分人拒絕了。code 講原因，error 用文字講明。

503application/json · text/plain

服務暫時用毋得；請等 Retry-After 裡肚个秒數過後再試。維護期間，內容係純文字，毋係錯誤封包。

5XXapplication/json

請求分人拒絕了。code 講原因，error 用文字講明。

codestring必填

請求分人拒絕个原因，係一隻穩定个代碼，做得用來分支處理：比如 insufficient_scope（403）、rate_limited（429），對按用量計費个用戶端還有 spend_cap_reached（402）㧯 metered_billing_inactive（402）。

errorstring必填

範例

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

想用函式庫？請看函式庫這一節。