Skip to content

2026-09-27-04 chat 用户新增批量查询 ex ​

1. 变更摘要 ​

本次新增 chat 用户扩展字段查询能力:

  • 新增接口:/user/find/ex
  • 变更内容:按 userIDs 批量返回 open-im-server 用户 ex
  • 字段语义:ex 原样透传,不做 JSON 结构化处理

2. 前端影响与动作 ​

  • 好友分页场景可在拿到 userIDs 后调用该接口,再与好友数据做本地合并展示。
  • 现有不依赖该能力的前端可不改。

动作等级:可不改

3. 接口变更清单 ​

3.1 新增接口 ​

说明路径状态链接
批量查询用户扩展字段 ex/user/find/exActive跳转

4. 兼容性说明 ​

  • 本次为新增接口,不影响既有接口请求和响应。
  • 不引入历史行为变更。

5. 前端对接步骤(最简) ​

  1. 好友列表分页返回后收集 userIDs。
  2. 调用 /user/find/ex 获取 ex。
  3. 以前端 userID 维度合并并展示。