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/groups | Active | 跳转 |
3.2 修改接口
无
3.3 删除接口
无
4. 兼容性说明
- 本次为增量新增接口,不影响现有 /adminx/user/search/full 的请求与响应。
- 前端可按需接入,不接入不影响现有用户管理列表功能。
5. 前端对接步骤(最简)
- 保持用户列表接口调用不变。
- 在用户行操作增加“查看所在群”。
- 点击后调用 /adminx/user/groups(传 userID + pagination)。
- 展示 groups 列表并支持翻页。