2026-06-28-01 管理员侧用户列表新增最后登录 IP(adminx)
1. 变更摘要
本次在管理员侧用户完整信息搜索接口中,增量返回用户最后登录 IP:
- 变更接口:
/adminx/user/search/full - 变更内容:
users.extra新增lastLoginIp字段 - 字段语义:用户最后一次登录记录的 IP;无登录记录时为空字符串
2. 前端影响与动作
- 如果管理后台需要展示用户登录来源,可直接读取
users.extra.lastLoginIp。 - 旧版本前端不读取该字段时不受影响。
- 如存在敏感信息展示规范,可在前端按需做脱敏显示。
动作等级:可选改
3. 接口变更清单
3.1 修改接口
| 说明 | 路径 | 状态 | 链接 |
|---|---|---|---|
| 搜索用户完整信息(增量) | /adminx/user/search/full | Active | 跳转 |
4. 兼容性说明
- 本次仅为响应结构新增可选字段,不改变原有请求参数与已有响应字段语义。
- Proto 采用追加字段方式,保持向后兼容。
- 旧客户端忽略未知字段时可无感升级。
5. 前端对接步骤(最简)
- 保持现有接口调用不变。
- 在用户列表展示层按需读取
users.extra.lastLoginIp。 - 若需要,增加 IP 脱敏显示规则。