Skip to content

2026-09-11-01 封禁用户搜索增加日期筛选(admin) ​

1. 变更摘要 ​

本次对管理员封禁用户搜索接口做增量增强:

  • 在 /admin/block/search 请求体新增可选字段 startTime、endTime
  • 支持按封禁创建时间(create_time)进行单边或区间筛选
  • 保持 keyword 搜索、手机号精确搜索与分页语义不变

2. 前端影响与动作 ​

  • 旧请求体无需修改,接口保持兼容。
  • 若页面有“按日期筛选”需求,可在请求体按需传入:
    • 仅传 startTime:筛选该时间及之后
    • 仅传 endTime:筛选该时间及之前
    • 同时传 startTime 和 endTime:筛选闭区间
  • 时间单位为 Unix 毫秒时间戳。

动作等级:按需改

3. 接口变更清单 ​

3.1 修改接口 ​

说明路径状态链接
搜索封禁用户/admin/block/searchCompatible跳转

3.2 新增接口 ​

无

3.3 删除接口 ​

无

4. 兼容性说明 ​

  • 本次为追加可选字段,不影响现有调用方。
  • 参数校验新增:
    • startTime < 0 或 endTime < 0 返回参数错误
    • startTime > endTime 返回参数错误
  • 其余行为与原接口保持一致。

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

  1. 保持现有分页参数与 keyword 逻辑不变。
  2. 新增日期筛选控件时,将日期转换为 Unix 毫秒并写入 startTime/endTime。
  3. 继续沿用现有错误处理分支,对参数错误提示做兜底展示。