Skip to content

2026-09-01-01 管理员侧按用户查询所在群列表(adminx)

1. 变更摘要

本次新增管理员侧单独接口,用于按用户 ID 查询该用户加入的群列表:

  • 新增接口:/adminx/user/groups
  • 返回结构:total + groups(GroupInfo 列表)
  • 查询模式:分页查询,最小可用

2. 前端影响与动作

  • 用户管理列表接口保持不变,仍使用 /adminx/user/search/full。
  • 在“用户详情”或“查看所在群”入口改为调用 /adminx/user/groups。
  • 建议使用分页展示,避免一次加载过多群数据。

动作等级:建议改

3. 接口变更清单

3.1 新增接口

说明路径状态链接
查询用户所在群列表/adminx/user/groupsActive跳转

3.2 修改接口

3.3 删除接口

4. 兼容性说明

  • 本次为增量新增接口,不影响现有 /adminx/user/search/full 的请求与响应。
  • 前端可按需接入,不接入不影响现有用户管理列表功能。

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

  1. 保持用户列表接口调用不变。
  2. 在用户行操作增加“查看所在群”。
  3. 点击后调用 /adminx/user/groups(传 userID + pagination)。
  4. 展示 groups 列表并支持翻页。