Skip to content

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/batchActive跳转

3.2 修改接口

3.3 删除接口

4. 兼容性说明

  • 本次为增量新增接口,不影响现有管理员侧好友查询接口。
  • 旧流程可继续使用;前端按需升级为批量调用。

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

  1. 在好友管理页面支持多选好友。
  2. 将目标用户 userID 与 friendUserIDs 数组提交到 /adminx/friend/delete/batch。
  3. 根据返回 results 渲染成功/失败提示与失败原因。