WuKongIM Docs

同步消息事件当前投影

编辑此页报告文档问题

接口边界

  • 调用方:仅限受信业务后端
  • 作用域:读取当前持久化 lane 投影,不返回完整事件日志。此入口不检查调用方身份或成员权限;include_private 由调用方直接控制,只能通过受信后端使用。
  • 成功判定:先读取 limit+1 条原始投影,再过滤 private/restricted;过滤后 more=0 或空页不保证更远处没有可见投影。next_msg_event_seq 只随实际返回项前进。
POST/message/eventsync

按序号游标读取当前持久化事件投影,不重放完整事件日志。在有界读取后过滤私有事件。调用方身份与 include_private 没有鉴权,必须由受信后端保护。

请求主体

application/json

要读取的消息事件身份、序号游标和筛选条件。

TypeScript 定义

在 TypeScript 中使用 request body 类型。

消息事件当前持久化投影读取参数;不验证成员身份。

响应主体

application/json

application/json

application/json

{  "status": 200,  "data": {    "client_msg_no": "string",    "from_msg_event_seq": 0,    "next_msg_event_seq": 0,    "more": 0,    "events": [      {        "msg_event_seq": 0,        "event_id": "string",        "event_key": "string",        "event_type": "string",        "visibility": "string",        "occurred_at": 0,        "payload": null      }    ],    "filtered_by_event_key": "string"  }}