查询可信发布者列表
1. 接口定位
- 接口名称: 查询可信发布者列表
- 所属域: admin/moments
- 业务目标: 返回当前全部可信发布者 userID 列表
2. 请求定义
- Method:
POST - Path:
/adminx/moments/trusted_publisher/find - Content-Type: 推荐
application/json - operationID: 必填,请通过 Header
operationID传入 - 鉴权: 需要 Header
token,且必须是管理员 token - 幂等性: 幂等(只读)
3. 请求参数
Header 参数
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| operationID | 是 | string | 链路追踪 ID |
| token | 是 | string | 管理员 token |
Body 参数
- 无业务参数,请传空对象
{}。
4. 响应结构
通用响应包裹
| 字段 | 类型 | 说明 |
|---|---|---|
| errCode | int | 错误码,0 表示成功 |
| errMsg | string | 错误简述 |
| errDlt | string | 错误详情 |
| data | object | 业务数据 |
data 字段
| 字段 | 类型 | 说明 |
|---|---|---|
| userIDs | array<string> | 可信发布者用户 ID 列表 |
5. 业务规则
- 仅管理员可调用。
- 返回值仅包含
userIDs,不包含用户资料和扩展字段。
6. 错误码与失败场景
| 错误码 | 场景 | 典型报错 |
|---|---|---|
| 1001 | token 缺失或无效 | 由鉴权链路返回 |
| - | 查询失败 | 由数据库层返回原始错误 |
7. 示例
fetch 请求示例
javascript
fetch("http://localhost:10011/adminx/moments/trusted_publisher/find", {
method: "POST",
headers: {
operationID: "adminx-moments-trusted-find-001",
token: "eyJhbGciOi...",
"Content-Type": "application/json",
},
body: JSON.stringify({}),
})
.then((res) => res.json())
.then((data) => console.log(data));成功响应示例
json
{
"errCode": 0,
"errMsg": "",
"errDlt": "",
"data": {
"userIDs": ["9000000001", "9000000002"]
}
}8. 变更记录
- 2026-06-01: 首版发布,新增动态可信发布者查询接口。