2026-09-03-01 管理后台批量删除好友(adminx)
1. 变更摘要
本次新增管理员侧批量删除好友接口,用于在后台对指定用户执行批量好友关系清理:
- 新增接口: /adminx/friend/delete/batch
- 返回结构: total + successCount + failedCount + successUserIDs + results
- 失败策略: 单条失败不影响后续条目,最终按条返回处理结果
2. 前端影响与动作
- 如果后台当前仅支持逐条删除好友,可切换为单次提交多 userID 的批量调用。
- 建议在结果页展示 successCount/failedCount 与失败原因明细,便于运营回溯。
- 入参中重复或空白 userID 会被标记失败,不会调用删除。
动作等级:建议改
3. 接口变更清单
3.1 新增接口
| 说明 | 路径 | 状态 | 链接 |
|---|---|---|---|
| 批量删除好友 | /adminx/friend/delete/batch | Active | 跳转 |
3.2 修改接口
无
3.3 删除接口
无
4. 兼容性说明
- 本次为增量新增接口,不影响现有管理员侧好友查询接口。
- 旧流程可继续使用;前端按需升级为批量调用。
5. 前端对接步骤(最简)
- 在好友管理页面支持多选好友。
- 将目标用户 userID 与 friendUserIDs 数组提交到 /adminx/friend/delete/batch。
- 根据返回 results 渲染成功/失败提示与失败原因。