获取动态审核详情

1. 接口定位

• 接口名称: 获取动态审核详情
• 所属域: admin/moments
• 业务目标: 查询单条动态的审核详情，用于审核台查看内容与当前审核状态

2. 请求定义

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

3. 请求参数

Header 参数

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

Body 参数

字段	必填	类型	说明
postID	是	string	动态 ID

4. 响应结构

通用响应包裹

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

data 字段

字段	类型	说明
post	object	动态审核详情

post 字段

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

user 对象

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

5. 业务规则

• 仅管理员可调用。
• 当前实现不限制状态，可查询待审核、已通过、已驳回三种状态的动态详情。

6. 错误码与失败场景

错误码	场景	典型报错
1001	postID 为空	postID is required
-	动态不存在	由数据库层返回原始错误

7. 示例

fetch 请求示例

fetch("http://localhost:10011/adminx/moments/review/detail", {
  method: "POST",
  headers: {
    operationID: "adminx-moments-review-detail-001",
    token: "eyJhbGciOi...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    postID: "post_1001",
  }),
})
  .then((res) => res.json())
  .then((data) => console.log(data));

成功响应示例

{
  "errCode": 0,
  "errMsg": "",
  "errDlt": "",
  "data": {
    "post": {
      "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 兼容。