举报详情

1. 接口定位

• 接口名称: 举报详情
• 所属域: admin/report
• 业务目标: 根据举报 ID 获取完整举报记录

2. 请求定义

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

3. 请求参数

Header 参数

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

Body 参数

字段	必填	类型	说明
reportID	是	string	举报 ID

字段约束

• reportID 不能为空。

4. 响应结构

通用响应包裹

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

data 字段

字段	类型	说明
report	object	举报完整信息

report 字段定义与“分页查询举报”接口 reports 元素一致。

5. 业务规则

• 仅管理员可调用。
• 当 reportID 不存在时返回错误。

6. 错误码与失败场景

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

7. 示例

fetch 请求示例

fetch("http://localhost:10011/adminx/report/detail", {
  method: "POST",
  headers: {
    operationID: "adminx-report-detail-001",
    token: "eyJhbGciOi...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    reportID: "9f0af0ce-9f6d-4dbf-8ab8-0b04f1f2b7f0",
  }),
})
  .then((res) => res.json())
  .then((data) => console.log(data));

8. 变更记录

• 2026-08-29: 首版发布，新增举报详情接口。