OpenIM Chat Docs

Appearance

2026-05-30-01 管理员侧用户列表查询（adminx） ​

1. 变更摘要 ​

本次新增 adminx 用户完整信息搜索接口，用于管理员侧用户列表查询场景：

  • 新增管理员侧用户列表查询接口
  • 请求与 chat/user/search/full 保持同类语义，降低迁移成本
  • 默认按 create_time desc 做稳定排序
  • 增量支持 sortField/sortOrder 白名单排序

2. 前端影响与动作 ​

  • 如果后台当前通过 /chat/user/search/full 查询用户列表，建议迁移到 /adminx/user/search/full，以匹配 adminx 域边界。
  • 若前端只需要现有分页展示能力，本次可保持不改；旧接口仍然可用。
  • 如果需要列表排序，建议优先使用默认排序，再按需传入 sortField/sortOrder。

动作等级：建议改

3. 接口变更清单 ​

3.1 新增接口 ​

说明路径状态链接
搜索用户完整信息/adminx/user/search/fullActive跳转

3.2 修改接口 ​

无

3.3 删除接口 ​

无

4. 兼容性说明 ​

  • 新接口独立于 /chat/user/search/full，不会改变旧接口的请求和响应结构。
  • 新接口支持 keyword 可空、pagination 必填、sortField/sortOrder 可选。
  • 默认排序为 create_time desc，并使用 user_id 作为稳定次序字段，适合分页场景。
  • 响应调整为组合结构：users.base 复用 common.UserFullInfo，users.extra 提供管理员侧扩展字段。
  • users.extra 中包含 registerTime（注册时间，Unix 毫秒时间戳）和 lastLoginTime（最后登录时间，Unix 毫秒时间戳；无登录记录时为 0）。

5. 前端对接步骤（最简） ​

  1. 管理后台登录后，继续使用现有管理员 token。
  2. 将用户列表接口切换到 /adminx/user/search/full。
  3. 如果需要排序，在请求体中补充 sortField 和 sortOrder。
  4. 如果不传排序参数，直接使用默认稳定排序即可。