v1
latestSwagger 2.02026-07-17443368.1 KBmessage
查询指定 vchannel 下的消息列表。支持以下几种查询算法:
latest
查询 vchannel 下最新的消息,支持参数:
- limit: 查询数量限制,最大值为 100, 默认 20
since
从指定位置开始拉取若干条消息,支持参数:
- key: 开始位置的消息 key, 不可以和 ts 同时使用
- ts: 开始位置的消息 ts, 不可以和 ts 同时使用
- forward: 向前(时间发生方向)获取条数
- backward: 向后(时间发生方向)获取条数
注意:
- 使用 key 查询时,查询区间不包括 key 对应的消息
- 使用 ts 查询时,查询区间包括 ts 对应的消息
- forward / backward 参数可以同时使用
- forward / backward 参数最大值为 100,
- forward / backward 均未指定时,默认使用 forward=100
window
拉取一定时间窗口内的消息,支持参数:
- from_key / to_key: 窗口区间的消息 key
- from_ts / to_ts: 窗口区间的消息 ts
- forward: 从 from 方向往 to 方向取的消息数
- backward: 从 to 方向往 from 方向取的消息数
注意:
- {from,to}_key 和 {from,to}_ts 不可以混用
- 使用 {from,to}_key 查询时,查询区间不包括 key 对应的消息
- 使用 {from,to}_ts 查询时,查询区间包括 ts 对应的消息
- forward 和 backward 参数只能选其中一个
- forward / backward 均未指定时,默认使用 forward=100
- 如果查询区间开始值比结束值大,返回空结果
post/message.query
Request body
Example request
{
"vchannel_id": "=bw52O"
}Response
request success