概述
同步指定频道的消息,支持按消息序号范围获取消息列表。请求体
必传参数
当前登录用户 ID
频道 ID
频道类型 (1=个人频道, 2=群组频道)
可选参数
起始消息序号(包含)
结束消息序号(不包含)
返回消息数量限制,最大 10000
拉取模式 (0=向下拉取, 1=向上拉取)
响应字段
响应是一个消息对象数组,每个消息对象包含:消息 ID
消息序列号
客户端消息编号
发送者用户 ID
频道 ID
频道类型
消息时间戳
Base64 编码的消息内容
状态码
| 状态码 | 说明 |
|---|---|
| 200 | 消息同步成功 |
| 400 | 请求参数错误 |
| 403 | 没有访问权限 |
| 500 | 服务器内部错误 |
最佳实践
- 合理设置范围:避免一次性同步过多消息
- 分页处理:使用 limit 参数控制返回数量
- 错误处理:处理网络错误和权限错误
- 缓存策略:合理缓存已同步的消息
- 性能优化:根据实际需求调整同步频率

