读取资料审核头像¶
请求参数¶
完整八项公共头、独立管理员Cookie及可信HTTPS必填,固定admin/web/admin_web,OWNER和VIEWER均可读。仅此精确GET媒体路径不套JSON JWE,不豁免身份、客户端元数据或传输保护。
| 参数 | 类型/必填 | 说明 |
|---|---|---|
| id | 路径UUID,是 | 审核项ID,不是用户或图片ID |
| source | 路径string,是 | submitted待审引用/previous入队时公开引用,使用详情返回URL,不拼外部路径 |
文本项、没有原头像、审核项不存在或已注销清理返回404,不回退默认图作为待审材料。
请求示例¶
GET /api/v1/admin/profile-reviews/00000000-0000-4000-8000-000000000001/avatars/submitted HTTP/1.1
X-Client-Type: admin
X-Platform: web
X-App-Version: 1.0.0
X-App-Build: 1
X-Channel: admin_web
X-Device-Id: 00000000-0000-4000-8000-000000000002
X-Request-Id: 00000000-0000-4000-8000-000000000003
X-Request-Timestamp: <当前13位毫秒时间戳>
Accept-Language: zh-CN
Cookie: <浏览器自动携带的管理员Cookie>
成功响应¶
HTTP200,Content-Type:image/png,Cache-Control:no-store,X-Content-Type-Options:nosniff,正文为实际规范化PNG字节,无ApiResponse或JWE外层。不提供公共直链,不包含原图元数据;关闭时释放预览引用,退出或换号时清空全部同源Blob,不能在URL放Cookie、Token或CSRF。
失败响应¶
| HTTP | code | 条件/处理 |
|---|---|---|
| 400 | INVALID_CLIENT_HEADERS/BAD_REQUEST | 公共头或来源不合法;精确媒体来源仅两种值 |
| 401/403 | UNAUTHORIZED/FORBIDDEN | 无有效Cookie或无读取权限 |
| 404 | NOT_FOUND | 非头像项、该引用为空、不存在、归属不符或注销已清理 |
| 426/429 | HTTPS_REQUIRED/TOO_MANY_REQUESTS | TLS或网关限制 |
| 503 | SERVICE_UNAVAILABLE | 文件、数据库或Redis依赖不可用 |
媒体错误按普通JSON ApiResponse返回,固定code,message支持中英日韩及英文回退;不是图片或JWE正文。
接入说明¶
后台头像与资料审核图片共用当前管理员会话的内存及IndexedDB缓存:账号头像按userId+avatarId、审核图片按审核项+来源+avatarId标识;同图并发合并,已验证图片切换菜单或强制刷新后可复用。两层缓存各最多64项/32MiB,下载成功后固定保留5分钟且不超过会话有效期,命中不延长有效期,超限按最近使用顺序淘汰;图片标识变化使用新文件,失败或损坏图片不缓存。刷新先经服务器恢复身份,再按管理员、会话及权限摘要选择缓存,摘要不含明文凭据;退出、换号或权限范围变化清理旧副本。列表/详情JSON仍每次读取,命中也校验当前权限与精确媒体路径,并实际解码后才允许通过头像审核。头像尚在加载时使用中性占位,不先显示默认头像;只有未设置头像或读取失败才回退默认素材。HTTP媒体继续no-store及同源Cookie/公共头,不把Cookie、CSRF或Blob地址写入持久存储;IndexedDB不可用时退回正常下载和内存缓存,最后一个未完成引用离开才取消下载。
候选与previous均是入队时的不可变引用;不使用当前用户新草稿替换历史图片。后台根据详情返回的精确URL读取,头像通过前必须成功加载submitted,失败只能重试或明确处理,不能显示演示图后通过。公开App头像仍按最后已通过引用读取,本接口不改变公开可见性。
身份、分项审核、版本及注销清理边界见资料审核。JSON列表/详情/决定继续强制真实JWE,不扩大整个profile-reviews命名空间的媒体例外。
验证范围¶
2026-11-06已随Java及后台统一版本部署,Flyway V29成功。服务器clean verify 631项全部通过,覆盖本人/公开隔离、分项决定、旧值保留、补审迁移、版本并发、独立权限、真实JWE、四语、审计回滚和注销清理。后台隔离页面21项功能及24项四语/宽度检查通过。实际入口23项只读检查通过,未写真实用户资料或创建App测试账号;后台另完成17项真实入口只读页面验收。当前队列为空,未在线上执行实际审核或读取真实待审头像,真实图片与决定以隔离测试为准。
后台网页优先将本接口路径交给申请后台媒体下载,取得单文件CDN授权后读取。本文原文件协议继续兼容;CDN鉴权失败不会自动回退。