精确查询已提交消息
接口边界
- 调用方:仅限受信业务后端
- 作用域:按当前成员可见范围读取精确消息索引,不使用近期历史扫描代替。
- 成功判定:选择项取并集,按序号去重排序;超限或任一读取失败不返回部分结果。
- 恢复:全部节点须支持精确查询 RPC;旧节点会明确拒绝。
POST
/messages按成员可见范围精确查询已提交消息;选择项、结果或索引检查超限时明确失败,不返回部分结果。
请求主体
application/json
TypeScript 定义
在 TypeScript 中使用 request body 类型。
按当前用户的频道可见范围精确选择消息。多个数组取并集,结果按序号去重排序,选择项总数为 1–128。
按当前用户的频道可见范围精确选择消息。多个数组取并集,结果按序号去重排序,选择项总数为 1–128。
响应主体
application/json
application/json
application/json
{ "start_message_seq": 0, "end_message_seq": 0, "more": 0, "messages": [ { "header": { "no_persist": 0, "red_dot": 0, "sync_once": 0 }, "setting": 0, "message_id": 0, "message_idstr": "string", "client_msg_no": "string", "end": 0, "end_reason": 0, "error": "string", "stream_data": "string", "event_meta": { "has_events": true, "completed": true, "event_version": 0, "last_msg_event_seq": 0, "event_count": 0, "open_event_count": 0, "events": [ { "event_key": "string", "status": "string", "last_msg_event_seq": 0, "snapshot": null, "end_reason": 0, "error": "string" } ] }, "event_sync_hint": { "client_msg_no": "string", "from_msg_event_seq": 0 }, "message_seq": 0, "from_uid": "string", "channel_id": "string", "channel_type": 0, "topic": "string", "expire": 0, "timestamp": 0, "payload": "string" } ]}