举报用户¶
请求参数¶
| 字段 | 位置 | 类型与必填 | 规则 |
|---|---|---|---|
| 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禁止自动回退旧程序,失败使用兼容修复或经验证的受控备份恢复。