搜索可信发布者

1. 接口定位

• 接口名称: 搜索可信发布者
• 所属域: admin/moments
• 业务目标: 按关键字分页查询可信发布者，并返回用户资料与操作信息

2. 请求定义

• Method: POST
• Path: /adminx/moments/trusted_publisher/search
• Content-Type: 推荐 application/json
• operationID: 必填，请通过 Header operationID 传入
• 鉴权: 需要 Header token，且必须是管理员 token
• 幂等性: 幂等（只读）

3. 请求参数

Header 参数

字段	必填	类型	说明
operationID	是	string	链路追踪 ID
token	是	string	管理员 token

Body 参数

字段	必填	类型	说明
keyword	否	string	按 userID 模糊搜索关键字
pagination	是	object	分页参数

pagination 字段

字段	必填	类型	说明
pageNumber	是	int32	页码，从 1 开始
showNumber	是	int32	每页条数，大于 0

4. 响应结构

通用响应包裹

字段	类型	说明
errCode	int	错误码，0 表示成功
errMsg	string	错误简述
errDlt	string	错误详情
data	object	业务数据

data 字段

字段	类型	说明
total	uint32	命中总数
users	array<object>	当前页可信发布者列表

users 元素字段

字段	类型	说明
userID	string	可信发布者 userID
reason	string	加入原因
operatorUserID	string	最近维护该记录的管理员 userID
createTime	int64	首次加入时间，Unix 毫秒时间戳
updateTime	int64	最近更新时间，Unix 毫秒时间戳
user	object	用户公开资料

user 对象

字段	类型	说明
userID	string	用户 ID
nickname	string	昵称
faceURL	string	头像 URL

5. 业务规则

• 仅管理员可调用。
• keyword 为空时返回全量分页结果。
• 搜索结果按创建时间倒序。

6. 错误码与失败场景

错误码	场景	典型报错
1001	pagination 为空或非法	pagination invalid
-	用户资料查询失败	由用户资料查询链路返回
-	搜索失败	由数据库层返回原始错误

7. 示例

fetch 请求示例

fetch("http://localhost:10011/adminx/moments/trusted_publisher/search", {
  method: "POST",
  headers: {
    operationID: "adminx-moments-trusted-search-001",
    token: "eyJhbGciOi...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    keyword: "9000",
    pagination: {
      pageNumber: 1,
      showNumber: 20,
    },
  }),
})
  .then((res) => res.json())
  .then((data) => console.log(data));

成功响应示例

{
  "errCode": 0,
  "errMsg": "",
  "errDlt": "",
  "data": {
    "total": 1,
    "users": [
      {
        "userID": "9000000001",
        "reason": "official account",
        "operatorUserID": "1000000001",
        "createTime": 1780200000000,
        "updateTime": 1780200000000,
        "user": {
          "userID": "9000000001",
          "nickname": "OpenIM Bot",
          "faceURL": "https://cdn.example.com/avatar/bot.png"
        }
      }
    ]
  }
}

8. 变更记录

• 2026-06-01: 首版发布，新增动态可信发布者搜索接口。