读取用户资料审核详情¶
请求参数¶
独立管理员Cookie、可信HTTPS及完整八项公共头必填,固定admin/web/admin_web;App Bearer与客户端自报角色不能授予权限。JSON使用真实JWE,GET信封通过X-Budyoo-JWE携带,不发送业务正文;写入还须同源Origin和X-Admin-CSRF。未知语言回退英文,字段与状态代码不翻译。
路径id为审核项UUID,非用户UUID或媒体UUID;无正文、无其他业务参数。返回不可变新旧对照,不用用户后来修改的草稿替换此候选。
请求示例¶
示例仅表示加密前业务内容,凭据及追踪字段按后台认证和公共头生成,不将Cookie或CSRF写入日志。
GET /api/v1/admin/profile-reviews/00000000-0000-4000-8000-000000000001
成功响应¶
HTTP200、Cache-Control:no-store、外层真实JWE;以下内容是合成示例,不代表线上审核操作。
{
"code": "SUCCESS",
"message": "操作成功。",
"data": {
"id": "00000000-0000-4000-8000-000000000001",
"userId": "00000000-0000-4000-8000-000000000002",
"publicId": "10000003",
"nickname": "示例昵称",
"avatarId": null,
"gender": "female",
"country": "jp",
"accountStatus": "ACTIVE",
"field": "NICKNAME",
"source": "PROFILE_EDIT",
"status": "PENDING",
"version": 0,
"isPublished": false,
"submittedAt": "2026-11-06T00:00:00Z",
"updatedAt": "2026-11-06T00:00:00Z",
"reviewedAt": null,
"reviewedBy": null,
"reason": "",
"submitted": {
"text": "示例昵称",
"avatarId": null,
"avatarUrl": null
},
"previous": {
"text": "原昵称",
"avatarId": null,
"avatarUrl": null
}
},
"errors": []
}
| Item字段 | 类型/可空 | 说明 |
|---|---|---|
| id/userId/publicId | UUID/UUID/string,非空 | 审核项、所属账号及稳定展示ID,不是手机号邮箱 |
| nickname/accountStatus | string可空/string非空 | 本人当前昵称(仅授权后台,未必已通过)及ACTIVE/DISABLED/DELETED账号状态 |
| avatarId/gender/country | UUID/string/string,可空 | 当前本人资料头像、性别和所选国家;账号展示使用,与submitted/previous审核快照分离;country不是IP归属,无资料国家不默认中国 |
| field | string,非空 | AVATAR/ALBUM/NICKNAME/INTRODUCTION,分别审核;ALBUM每条记录只对应一张照片 |
| albumPosition | integer,可空 | 仅ALBUM返回,照片在本人相册中的0–8位置;其他字段为null |
| source | string,非空 | REGISTRATION完成注册、PROFILE_EDIT两端资料修改、LEGACY旧资料补审 |
| status | string,非空 | PENDING/APPROVED/REJECTED/HIDDEN/SUPERSEDED |
| version/isPublished | integer/boolean,非空 | 独立审核修订及是否仍是该字段当前公开来源;旧通过历史不一定仍公开 |
| submittedAt/updatedAt | date-time,非空 | 入队/最近状态或公开来源变化时间;LEGACY入队为迁移时间 |
| reviewedAt/reviewedBy | date-time/UUID,可空 | 最近人工决定时间与管理员UUID;自动被替代不伪造人工决定 |
| reason | string,非空 | 决定原文,未填写为"";驳回/下架必须有原因,不自动翻译 |
| submitted/previous | object,非空 | 不可变候选/入队时已通过公开快照,不被用户后续编辑覆盖 |
| submitted.text/previous.text | string,可空 | 昵称或签名;头像项为null,previous可无原值 |
| submitted.avatarId/previous.avatarId | UUID,可空 | 头像引用;文本项为null |
| submitted.avatarUrl/previous.avatarUrl | string,可空 | 头像项固定的submitted/previous授权PNG地址 |
| submitted.photos/previous.photos | array | ALBUM单项只含当前这一张照片及固定授权PNG地址 |
失败响应¶
| HTTP | code | 条件/处理 |
|---|---|---|
| 400 | BAD_REQUEST/VALIDATION_FAILED/INVALID_CLIENT_HEADERS | 筛选、分页、字段类型、必填头或请求格式不合法 |
| 400 | ENCRYPTION_REQUIRED/INVALID_ENCRYPTED_REQUEST | JSON缺少真实JWE或认证失败 |
| 401/403 | UNAUTHORIZED/FORBIDDEN/ADMIN_CSRF_INVALID | 独立会话、角色权限、同源或写CSRF拒绝 |
| 404 | NOT_FOUND | 候选不存在、注销已清理,或该项没有所选头像 |
| 426/429 | HTTPS_REQUIRED/TOO_MANY_REQUESTS | 传输要求或入口限流 |
| 503 | SERVICE_UNAVAILABLE | 数据库、Redis或媒体依赖失败,不返回假成功 |
固定code,message与字段错误支持中英日韩,缺省英文;管理员填写原因按原文返回。
接入说明¶
逐项状态和本人/公开值边界见用户资料审核。保存或上传成功只代表本人提交,未审/驳回继续展示最后通过值;首次无通过值用默认头像/默认昵称/空签名/空相册。旧资料仅LEGACY补审,不自动通过。审核与资料编辑按同一用户行锁串行,审核成功及脱敏审计同事务;审核不更改本人编辑version、注册步骤或VIP。每次公开读取只用published值和已通过相册快照,社交昵称搜索也不匹配未审草稿;相册当前值在通过前只对本人可见,单张通过后只公开该照片位置。
后台菜单“用户资料审核”按字段及状态筛选,仅展示新提交内容,不显示“此前公开内容”列,也不读取previous头像;previous字段与入队时公开快照仍保留在接口契约中。账号区只显示头像、昵称及头像右下角资料国家国旗,不展示公开ID/UUID;这些标识仍保留在契约及搜索中。列表一次返回当前账号avatarId/gender/country,无逐行资料JSON读取;账号头像通过既有管理员用户头像接口加载(ADMIN_USER_PROFILES_READ),OWNER/VIEWER均具备。右侧PENDING直接提供“同意/拒绝”,已通过且仍公开的项保留下架;理由在拒绝/下架操作窗填写,空白禁止提交,成功刷新列表及统计。OWNER可写、VIEWER只读,操作由管理员明确选择,在途禁用重复提交和关闭。409、超时或503后保留意见并先GET详情核对,显式采用新版本后才继续,不自动重发决定。图片自身使用8px圆角,点击打开单张预览弹窗,预览复用已授权Blob。头像和相册通过前必须成功读取并解码待审PNG,加载失败提供重试;不能以占位图代替审核。注销会清除候选内容及文件引用,旧记录404不恢复用户资料。
验证范围¶
2026-11-08本地Java编译与后台类型检查通过;相册单张审核的Flyway V38已在服务器生效,版本20261108T111351Z-99f423f61835-worktree已完成迁移和接口回归验收。既有线上V29审核能力及只读验收记录继续保留,当前未在线上执行实际审核或读取真实待审头像。