GET/api/v1/admin/profile-reviews/{id}
独立Cookie、可信HTTPS、JWE、ADMIN_PROFILE_REVIEWS_READJSON 响应接入指南 ↗

读取用户资料审核详情

请求参数

独立管理员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审核能力及只读验收记录继续保留,当前未在线上执行实际审核或读取真实待审头像。