2026-04-15-01 管理员封禁列表查询
1. 变更摘要
本次补充 adminx 管理员封禁列表查询能力,用于支撑后台“封禁管理员列表 / 搜索 / 解封”场景:
- 新增封禁管理员分页搜索接口
- 返回封禁原因、操作人和封禁时间
- 同时补充当前页管理员基础资料
2. 前端影响与动作
- 若后台已有管理员封禁管理页,建议新增“封禁列表”视图。
- 搜索框当前建议按
userID、封禁原因、操作人 userID 进行搜索提示。 - 若需要按账号或昵称搜索,可在后续版本再扩展,不影响本次接入。
3. 接口变更清单
3.1 新增接口
| 说明 | 路径 | 状态 | 链接 |
|---|---|---|---|
| 搜索封禁管理员 | /adminx/account/block/search | Active | 跳转 |
3.2 修改接口
无
3.3 删除接口
无
4. 兼容性说明
- 本次只新增查询接口,不改变既有封禁、解封、登录审计接口的请求和响应结构。
- 新接口不影响现有管理员列表接口
/account/search。
5. 前端对接步骤(最简)
- 新增封禁管理员列表页或分页区域。
- 调用
/adminx/account/block/search拉取封禁列表。 - 列表中直接复用现有“解除封禁”操作。