列出事件

参数

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"

更喜欢用库？请参阅“库”部分。