列出事件

參數

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"

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