外观
首页与会话
登录后读取首页,再进入会话。会话 ID 直接使用服务器返回值。
每个接口独立列出请求参数、返回字段和示例。点击下方接口名称即可查看。
接口列表
| 接口 | 方法 | 路径 |
|---|---|---|
| 读取首页数据 | POST | /app/sdk/sync |
| 读取下一页会话 | GET | /app/sdk/conversations |
| 打开或定位会话 | GET | /app/sdk/conversations/resolve |
| 修改会话状态 | POST | /app/sdk/conversations/state |
| 读取未读数 | GET | /app/sdk/unread |
首页快照
登录后先读取首页,获得未读数、可用功能、上传限制和第一页会话。
更多会话
有下一页时,原样提交 next_cursor,继续读取会话。
解析聊天入口
从业务页打开某人的单聊或一个群时,用用户或群 ID 获取会话与最新消息。
会话状态
已读、置顶、免打扰分别由 action 控制;每次只提交该操作需要的字段。
只读聚合未读
只刷新消息角标和申请角标时,读取两个未读数即可。
