POST/api/v1/users/{userId}/reports
ROLE_USER、本人Bearer及八项App公共头、注册完成及VIP准入JSON 响应接入指南 ↗

举报用户

请求参数

字段 位置 类型与必填 规则
userId 路径 UUID,必填 真实用户目标,必须非本人;不接受动态或评论ID冒充
clientRequestId JSON UUID字符串,必填 同一举报者跨用户/动态/评论共用唯一幂等键
reason JSON string,必填 SPAM垃圾广告、INAPPROPRIATE不当内容、HARASSMENT骚扰、OTHER其他,固定大写
description JSON string或null,可选 省略/null为空;原输入最多300个UTF-16代码单元,再trim首尾空白,四种原因均允许空说明
evidenceIds JSON UUID字符串数组或null,可选 省略/null=[],0–3个去重的本人未过期、未绑定EVIDENCE编号,顺序参与幂等比较

无业务查询参数。未知字段及隐式标量转换拒绝,包括body里的userId、targetUserId、postId、commentId、reporterId、state、targetType;目标只来自路径,举报者只来自Bearer。UUID使用完整字符串,不能用数字或缩写补成UUID。

要求ROLE_USER、本人ACTIVE且注册完成、满足会话渠道VIP准入。八项公共头全部校验,安装/渠道/平台沿用会话绑定;提示支持中英日韩及英文回退,固定code与原因枚举不翻译。JSON使用统一响应及AES/JWE,正式要求可信HTTPS;显式dev固定码/HTTP兼容仅按原协议执行。

目标必须ACTIVE/COMPLETE。正常可见或已由本人屏蔽的目标可报;双方屏蔽与仅本人屏蔽同样允许,不向调用者暴露反向状态。对方单独屏蔽、失活、注销、未完成及不存在的新目标统一404。自报400。调用前使用主体capabilities.canReport,提交时服务器仍重新校验。

证据沿用通用媒体暂存,kind=EVIDENCE,每张输入≤5MiB的PNG/JPEG/WebP,规范化PNG且保持私有。必须使用当前举报者成功上传返回的编号,不接受URL、头像、相册、动态图片或其他账号编号。未绑定24小时到期;已绑定证据不按暂存到期删除。新举报每用户固定小时窗口20次,与动态/评论举报共用,幂等重试不重复占新额度。

请求示例

以下身份与编号均为合成示例。body为加密前JSON,真实发送时由统一客户端绑定POST路径及当前请求头并生成JWE。

POST /api/v1/users/00000000-0000-4000-8000-000000000001/reports HTTP/1.1
Authorization: Bearer <当前accessToken>
Accept-Language: zh-CN
X-Client-Type: app
X-Platform: android
X-App-Version: 1.0.0
X-App-Build: 1
X-Channel: xiaomi
X-Device-Id: 00000000-0000-4000-8000-000000000002
X-Request-Id: 00000000-0000-4000-8000-000000000003
X-Request-Timestamp: <当前13位毫秒时间戳>
Accept: application/jose
Content-Type: application/jose
X-Budyoo-Encryption: jwe-v1

<统一客户端生成的compact-JWE>
{
  "clientRequestId": "00000000-0000-4000-8000-000000000004",
  "reason": "HARASSMENT",
  "description": "请核查此用户的骚扰行为",
  "evidenceIds": ["00000000-0000-4000-8000-000000000005"]
}

成功响应

HTTP200、Cache-Control: no-store,认证解密后的完整合成示例如下。成功只代表真实收件,不能显示已封号、已处罚或自动拉黑。

{
  "code": "SUCCESS",
  "message": "操作成功。",
  "data": {
    "id": "00000000-0000-4000-8000-000000000006",
    "postId": null,
    "commentId": null,
    "clientRequestId": "00000000-0000-4000-8000-000000000004",
    "reason": "HARASSMENT",
    "description": "请核查此用户的骚扰行为",
    "state": "RECEIVED",
    "resolution": null,
    "version": 0,
    "createdAt": "2026-11-11T00:00:00Z",
    "updatedAt": "2026-11-11T00:00:00Z",
    "targetType": "USER",
    "targetUserId": "00000000-0000-4000-8000-000000000001"
  },
  "errors": []
}
字段 类型/nullable 含义
id UUID,非空 真实收件回执,供本人结果回查
postId、commentId null 用户举报不绑定动态或评论
clientRequestId UUID,非空 本次业务幂等键,原样归属举报者
reason string,非空 正式原因枚举
description string,非空 规范化说明,未填为空字符串
state string,非空 初次RECEIVED;以后PROCESSING、RESOLVED或DISMISSED
resolution string或null 初次null,处理说明只供举报者与获准管理员,不向目标公开
version long,非空 初次0,每次成功处理递增,App只读
createdAt、updatedAt ISO 8601,非空 实际首次收件及最近处理时间,幂等重放不改时间
targetType string,非空 本接口固定USER,共享回执另有POST/COMMENT
targetUserId UUID,非空 本次真实用户目标;共享内容举报此字段为null

回执沿用共享举报模型。本人列表新增scope=CONTENT/USER/ALL,默认CONTENT仅动态和评论,保护老客户端的非空postId假设;查看用户举报必须scope=USER,混合列表用scope=ALL。按回执ID查询不受列表scope限制,但只能当前举报者读取。

失败响应

HTTP code 处理
400 BAD_REQUEST/INVALID_CLIENT_HEADERS 自报、类型/未知字段/原因/长度/证据不合法或公共头错误
401 UNAUTHORIZED 匿名、失效会话、安装或渠道不匹配
403 FORBIDDEN/ACCOUNT_DISABLED 查看者状态、角色、注册或VIP准入不满足
404 NOT_FOUND 新目标不存在、失活、未完成、注销或对方单独屏蔽,统一不可见
409 POST_REVIEW_CONFLICT 共用幂等键对应不同类型/目标/原因/规范化说明/有序证据,沿用现有冲突码
429 AUTH_RATE_LIMITED 新举报共用小时额度超限
426 HTTPS_REQUIRED 当前模式要求可信HTTPS
503 SERVICE_UNAVAILABLE 必要目标、屏蔽、数据库、证据或回执依赖失败,整份失败并回滚
500 INTERNAL_ERROR 未预期失败,沿用标准错误响应

例如重复键改变内容返回HTTP409、code=POST_REVIEW_CONFLICT、data=null,message按当前语言;不可见目标返回HTTP404、code=NOT_FOUND、data=null,不提供对方是否屏蔽的说明。JWE、认证标签、请求大小及网关限流沿用公共协议,未认证响应不能作为成功回执。

接入说明

账号按固定UUID顺序加锁,与拉黑/注销串行;同一举报者并发同键也只收件一次。原动态/评论幂等摘要不改,用户目标独立摘要,不在动态ID列塞用户UUID。同键、同规范化内容重试直接返回原回执,目标后来失活或屏蔽也不重复新建;不同内容409。每次传输使用新的X-Request-Id及时间戳,只有业务clientRequestId按同一提交复用。

证据锁、收件、绑定和回执投影在同一事务内,任一失败回滚;不会新增主页访客、关注、拉黑、审核决定或处罚。新提交超时/结果不明时可按原幂等键及完全相同内容明确重试,不更换键制造重复举报。

只有本人可以读取回执和私有证据,目标和其他App用户均不可读。后台沿用独立Cookie/HTTPS/CSRF/JWE及ADMIN_POSTS_READ/WRITE;新版既有举报页面显式scope=ALL,区分用户/动态/评论目标并处理同一状态机,USER不请求伪造关联动态。处理说明与审计同事务,终态不可覆盖,不自动封禁。账号注销沿领域事务先排队删除证据,再删除举报者或用户目标相关举报;备份副本按既有保留规则处理。

2026-11-11服务器隔离PostgreSQL/Redis完整clean verify通过1070项,0失败/错误/跳过;本次新增用户举报15项、安全/回滚/注销16项、V40→V41升级1项及主页菜单20项。覆盖四种原因、三类共用幂等及额度、并发重试、四种屏蔽关系、严格JSON类型与未知字段、UTF-16边界、证据归属/目的/过期/重复绑定、故障事务回滚、隐私、后台权限/版本/审计、双侧注销及旧记录兼容;HTTP控制器及真实JWE正向收件只在隔离库。后台浏览器四语×桌面/手机8组隔离夹具通过,用户/动态/评论三类正确展示,用户目标不读取关联动态,VIEWER只读,运行请求与写入均0。开发版本20261111-user-menu-125906已发布,Flyway为V41,备份独立恢复与构建/运行摘要核对通过。公网35项dev HTTP标准JSON检查只使用既有空闲合成账号:用户举报核对匿名401、自报400、不存在404、未知字段400、安装不符401、本人列表scope及私有不存在回执404,未创建运行举报或上传证据;账号已退出,运行收件数量及旧记录摘要保持。正向收件、证据、幂等/额度、后台处理及JWE由上述隔离测试覆盖,未使用真实用户验收,不将夹具当运行收件。V41禁止自动回退旧程序,失败使用兼容修复或经验证的受控备份恢复。