2026-09-27-01 用户官方标识(adminx)
1. 变更摘要
本次新增管理员侧用户官方标识能力:
- 新增接口:
/adminx/user/official/set - 变更接口:
/adminx/user/search/full - 变更内容:
users.extra新增isOfficial字段 - 写入策略:修改时双写 chat 属性表与 OpenIM Server 用户
ex(JSON merge,仅更新isOfficial,不覆盖其他字段)
2. 前端影响与动作
- 若后台需要展示官方账号标识,可直接读取
users.extra.isOfficial。 - 若后台需要修改官方标识,调用
/adminx/user/official/set即可。 - 旧版本前端不读取该字段时不受影响。
动作等级:建议改
3. 接口变更清单
3.1 新增接口
| 说明 | 路径 | 状态 | 链接 |
|---|---|---|---|
| 设置用户官方标识 | /adminx/user/official/set | Active | 跳转 |
3.2 修改接口
| 说明 | 路径 | 状态 | 链接 |
|---|---|---|---|
| 搜索用户完整信息(增量字段) | /adminx/user/search/full | Active | 跳转 |
4. 兼容性说明
search/full仅新增响应字段,不变更既有字段语义,保持向后兼容。- 新增接口为增量能力,不影响存量接口。
- 双写失败会回滚本地
is_official修改,降低数据不一致风险。
5. 前端对接步骤(最简)
- 用户列表按需读取
users.extra.isOfficial展示官方标识。 - 管理端新增开关操作,调用
/adminx/user/official/set。 - 失败时透出接口错误,提示稍后重试。