分页查询举报

1. 接口定位

• 接口名称: 分页查询举报
• 所属域: admin/report
• 业务目标: 管理员按对象类型、状态、关键字分页检索举报记录

2. 请求定义

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

3. 请求参数

Header 参数

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

Body 参数

字段	必填	类型	说明
targetType	否	string	对象类型过滤：user/group/moment
status	否	int32	状态过滤：0 全部、1 待处理、2 已通过、3 已驳回
keyword	否	string	关键字，匹配 reportID/reporterUserID/targetID/原因
pagination	是	object	分页参数

pagination 字段

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

字段约束

• targetType 非空时仅允许 user/group/moment。
• status 仅允许 0/1/2/3。
• pagination 不能为空。

4. 响应结构

通用响应包裹

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

data 字段

字段	类型	说明
total	uint32	命中总数
reports	array<object>	举报记录列表

reports 元素字段

字段	类型	说明
reportID	string	举报 ID
reporterUserID	string	举报人用户 ID
targetType	string	举报对象类型
targetID	string	举报对象 ID
reasonCode	string	原因编码
reasonText	string	原因说明
evidenceURLs	array<string>	证据链接
sourceScene	string	来源场景
sourceID	string	来源对象 ID
operationID	string	上报链路 operationID
reporterIP	string	上报 IP
userAgent	string	上报 User-Agent
status	int32	状态：1 待处理、2 已通过、3 已驳回
handlerUserID	string	处理人用户 ID
handleNote	string	处理备注
handleTime	int64	处理时间，Unix 毫秒时间戳；未处理为 0
createTime	int64	创建时间，Unix 毫秒时间戳
updateTime	int64	更新时间，Unix 毫秒时间戳

5. 业务规则

• 仅管理员可调用。
• 结果按 createTime 倒序返回。

6. 错误码与失败场景

错误码	场景	典型报错
1001	targetType 非法	targetType must be user/group/moment
1001	status 非法	status must be 0/1/2/3
1001	pagination 为空	pagination is empty
-	查询失败	由数据库层返回原始错误

7. 示例

fetch 请求示例

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

成功响应示例

{
  "errCode": 0,
  "errMsg": "",
  "errDlt": "",
  "data": {
    "total": 1,
    "reports": [
      {
        "reportID": "9f0af0ce-9f6d-4dbf-8ab8-0b04f1f2b7f0",
        "reporterUserID": "u_1001",
        "targetType": "moment",
        "targetID": "post_10001",
        "reasonCode": "porn",
        "reasonText": "疑似违规内容",
        "evidenceURLs": ["https://cdn.example.com/report/evidence-1.jpg"],
        "sourceScene": "feed",
        "sourceID": "post_10001",
        "operationID": "chatx-report-submit-001",
        "reporterIP": "10.0.0.2",
        "userAgent": "iOS/1.0.0",
        "status": 1,
        "handlerUserID": "",
        "handleNote": "",
        "handleTime": 0,
        "createTime": 1787990000000,
        "updateTime": 1787990000000
      }
    ]
  }
}

8. 变更记录

• 2026-08-29: 首版发布，新增举报分页查询接口。