读取用户资料审核队列¶
请求参数¶
独立管理员Cookie、可信HTTPS及完整八项公共头必填,固定admin/web/admin_web;App Bearer与客户端自报角色不能授予权限。JSON使用真实JWE,GET信封通过X-Budyoo-JWE携带,不发送业务正文;写入还须同源Origin和X-Admin-CSRF。未知语言回退英文,字段与状态代码不翻译。
| 参数 | 类型/默认 | 说明 |
|---|---|---|
| status | string,PENDING | ALL/PENDING/APPROVED/REJECTED/HIDDEN/SUPERSEDED |
| field | string,ALL | ALL/AVATAR/ALBUM/NICKNAME/INTRODUCTION |
| q | string,"" | 原输入≤80 UTF-16;trim后按用户UUID/publicId精确或本人当前昵称字面包含搜索,不查询手机号邮箱 |
| page/pageSize | integer,1/20 | page为1–100000,pageSize为1–100;固定按入队时间和内部序号倒序 |
统计随列表一次返回,使用相同field/q过滤,但不受当前status标签限制;数据与总数处于同一只读快照。侧栏“用户资料审核”气泡表示全局PENDING资料项数,头像/相册/昵称/签名逐项计数,不是用户数或当前页行数;0时隐藏。审核页无字段及关键词筛选的统计直接复用,其他页面及筛选后决定成功时通过同一路径使用status=PENDING、field=ALL、空q、page=1、pageSize=1读取total,不新增统计端点、不下载头像。可见页面每30秒按需检查,窗口恢复时刷新;无权限不读取,退出清空并取消旧请求,读取失败不伪造0。
后台网页顶部提供“头像/相册/昵称/个性签名”四个审核分类,首次进入和重置默认头像待审核(field=AVATAR、status=PENDING)。下方以紧凑按钮展示全部状态及五种状态数量,数量来自当前分类与已应用关键词的同次statistics响应,全部为五项之和;加载或失败显示未知占位。点击分类保留已选状态和已应用关键词,点击状态保留分类,均回到第一页;未提交的搜索草稿不影响切换、分页或刷新。接口的field缺省值仍为ALL,保持其他调用方兼容;侧栏气泡在首屏独立读取全局待审总数,不采用当前分类数量。
请求示例¶
示例仅表示加密前业务内容,凭据及追踪字段按后台认证和公共头生成,不将Cookie或CSRF写入日志。
GET /api/v1/admin/profile-reviews?status=PENDING&field=ALL&page=1&pageSize=20
成功响应¶
HTTP200、Cache-Control:no-store、外层真实JWE;以下内容是合成示例,不代表线上审核操作。
{
"code": "SUCCESS",
"message": "操作成功。",
"data": {
"items": [
{
"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
}
}
],
"total": 1,
"page": 1,
"pageSize": 20,
"hasMore": false,
"statistics": {
"pending": 1,
"approved": 0,
"rejected": 0,
"hidden": 0,
"superseded": 0
}
},
"errors": []
}
外层items为Item数组,total为当前筛选总数,page/pageSize原样返回,hasMore表示还有下一页;statistics为相同field/q下五种状态的真实总数,空结果为0。
| 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提供“同意/拒绝”;相册每张照片独立一行、独立版本和独立决定,不再把多张照片合并在同一列表项;点击“同意”直接按当前列表version提交APPROVE及空reason,不弹操作窗或二次确认,成功刷新列表、统计及全局待审气泡。提交中显示加载并禁用重复操作、筛选、分页和离开;同意遇到409、超时或503时在列表提示并锁定操作,须手动刷新成功、查看最新内容后才能再次点击,不自动重发。已通过且仍公开的项保留下架;拒绝/下架仍在操作窗填写必填理由,空白禁止提交,冲突或未知结果保留意见并先GET详情核对,显式采用新版本后才继续。OWNER可写、VIEWER只读。图片自身使用8px圆角,点击打开单张预览弹窗,预览复用已授权Blob。头像和相册通过前必须成功读取并解码对应待审PNG,加载失败提供重试;不能以占位图代替审核。注销会清除候选内容及文件引用,旧记录404不恢复用户资料。
验证范围¶
2026-11-08本地Java编译、后台npm run typecheck与npm run build通过;相册单张审核的Flyway V38已在服务器生效,版本20261108T111351Z-99f423f61835-worktree已完成迁移和接口回归验收。既有线上V29审核能力及只读验收记录继续保留,当前未在线上执行实际审核或读取真实待审头像。