Skip to content

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

3.2 修改接口 ​

说明路径状态链接
搜索用户完整信息(增量字段)/adminx/user/search/fullActive跳转

4. 兼容性说明 ​

  • search/full 仅新增响应字段,不变更既有字段语义,保持向后兼容。
  • 新增接口为增量能力,不影响存量接口。
  • 双写失败会回滚本地 is_official 修改,降低数据不一致风险。

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

  1. 用户列表按需读取 users.extra.isOfficial 展示官方标识。
  2. 管理端新增开关操作,调用 /adminx/user/official/set。
  3. 失败时透出接口错误,提示稍后重试。