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/search | Compatible | 跳转 |
3.2 新增接口
无
3.3 删除接口
无
4. 兼容性说明
- 本次为追加可选字段,不影响现有调用方。
- 参数校验新增:
startTime < 0或endTime < 0返回参数错误startTime > endTime返回参数错误
- 其余行为与原接口保持一致。
5. 前端对接步骤(最简)
- 保持现有分页参数与 keyword 逻辑不变。
- 新增日期筛选控件时,将日期转换为 Unix 毫秒并写入
startTime/endTime。 - 继续沿用现有错误处理分支,对参数错误提示做兜底展示。