机器人事件

读取机器人事件

GET /v1/bots/me/events
GET/v1/bots/me/events
下载规范

使用机器人自身 Bot PAT 或经审核机器人 OAuth 应用签发的 OAuth access token,按十进制游标读取当前仍有权限查看的私信和房间指令事件,每页最多 50 条;断线后可用 next_after 补取。OAuth 应用审核和 bot 权限 grant 均必须有效;令牌主体始终是绑定的 bot user。事件保留 90 天,清理不重置序号;无新事件时 next_after 不小于请求的 after。

Bearer 令牌(bot:events:read)

查询参数

afterstring可选

长度 ≤ 19 · 格式:^[0-9]{1,19}$

limitstring可选

格式:^(?:[1-9]|[1-4][0-9]|50)$

返回值

Success

eventsobject[]必填

条目数 ≤ 50

event_idstring必填
seqstring必填

长度 ≤ 19 · 格式:^[0-9]{1,19}$

message_idstring必填
room_idstring | null必填
conversation_idstring | null必填
trigger_kindstring必填
可选值"dm""mention""slash"
command_idstring | null必填
command_revisionnumber | null必填
argsstring[]必填
[]string
contentstring必填
author_idstring必填
created_atstring必填
next_afterstring必填

长度 ≤ 19 · 格式:^[0-9]{1,19}$

接口信息

接口: GET /v1/bots/me/events
operationId: listBotEvents

所需权限: bot:events:read

使用机器人自身 Bot PAT 或经审核机器人 OAuth 应用签发的 OAuth access token,按十进制游标读取当前仍有权限查看的私信和房间指令事件,每页最多 50 条;断线后可用 next_after 补取。OAuth 应用审核和 bot 权限 grant 均必须有效;令牌主体始终是绑定的 bot user。事件保留 90 天,清理不重置序号;无新事件时 next_after 不小于请求的 after。

参数:

  • query after
  • query limit