分页查询待审核动态

1. 接口定位

• 接口名称: 分页查询待审核动态
• 所属域: admin/moments
• 业务目标: 在 AdminX 后台域分页获取当前处于待审核状态的朋友圈动态

2. 请求定义

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

3. 请求参数

Header 参数

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

Body 参数

字段	必填	类型	说明
pagination	是	object	分页参数

pagination 字段

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

字段约束

• pagination 不能为空。
• pageNumber 和 showNumber 必须都大于 0。

4. 响应结构

通用响应包裹

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

data 字段

字段	类型	说明
total	uint32	命中总数
posts	array<object>	当前页动态列表

posts 元素字段

字段	类型	说明
postID	string	动态 ID
userID	string	发帖用户 ID
user	object	发帖用户公开资料
content	string	文本内容
mediaURLs	array<string>	媒体地址列表
visibility	int32	可见性级别
auditStatus	int32	审核状态，当前列表固定为 0（待审核）
auditReason	string	审核原因，待审核时通常为空
reviewer	string	审核人用户 ID，待审核时为空
reviewedAt	int64	审核时间，Unix 毫秒时间戳；未审核为 0
createTime	int64	发帖时间，Unix 毫秒时间戳

user 对象

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

5. 业务规则

• 仅管理员可调用。
• 结果按创建时间倒序返回（由底层审核查询实现决定）。
• 该接口只返回待审核状态动态，不返回已通过或已驳回数据。

6. 错误码与失败场景

错误码	场景	典型报错
1001	pagination 参数非法	pagination invalid
-	查询失败	由数据库层返回原始错误

7. 示例

fetch 请求示例

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

成功响应示例

{
  "errCode": 0,
  "errMsg": "",
  "errDlt": "",
  "data": {
    "total": 1,
    "posts": [
      {
        "postID": "post_1001",
        "userID": "u_2001",
        "user": {
          "userID": "u_2001",
          "nickname": "Alice",
          "faceURL": "https://cdn.example.com/avatar/a.png"
        },
        "content": "周末去露营",
        "mediaURLs": ["https://cdn.example.com/moments/1001-1.jpg"],
        "visibility": 1,
        "auditStatus": 0,
        "auditReason": "",
        "reviewer": "",
        "reviewedAt": 0,
        "createTime": 1780200000000
      }
    ]
  }
}

8. 变更记录

• 2026-06-01: 首版发布，新增 AdminX 动态待审核分页查询接口文档。
• 2026-06-01: 响应新增 user 发帖用户公开资料字段，保留 userID 兼容。