读取用户已审公开相册照片¶
请求参数¶
| 参数 | 位置 | 类型与必填 | 含义 |
|---|---|---|---|
| userId | 路径 | UUID,必填 | 目标用户,来自用户主页profile.userId |
| photoId | 路径 | UUID,必填 | 用户主页album.photos[].id的当前已审公开照片 |
无查询参数、无请求体。直接使用用户主页主体返回的album.photos[].url,不构造本人私有相册路径、不把候选编号当公开引用。每次独立校验Bearer、ROLE_USER、注册完成、VIP准入、目标ACTIVE/COMPLETE、双向屏蔽、当前已审引用及文件归属/软删除;知道UUID或曾读过旧URL不授予权限。
包括自看在内,本路径只读取目标当前已审公开照片。未绑定暂存、待审、驳回或已撤下照片不公开;原本人照片入口保留私有能力,不对其他Bearer开放。图片读取不会新增或更新访客。
必须发送八项App公共头,安装ID、平台/渠道与会话一致,身份来自Authorization。媒体免JSON JWE,沿用加密范围;正式要求可信HTTPS,不关闭证书校验。错误提示按Accept-Language四语及英文回退。
请求示例¶
以下UUID为合成示例;安装ID、请求编号、时间戳及Token由统一客户端生成。
GET /api/v1/media/user-albums/00000000-0000-4000-8000-000000000001/00000000-0000-4000-8000-000000000004 HTTP/1.1
Authorization: Bearer <当前accessToken>
Accept: image/png
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位毫秒时间戳>
成功响应¶
HTTP200,正文为实际规范化PNG字节,没有JSON外层、JWE信封或文件系统地址。
| 响应头 | 值 |
|---|---|
| Content-Type | image/png |
| Content-Length | 实际字节数,与当前不可变图片对应 |
| Cache-Control | no-store |
| X-Content-Type-Options | nosniff |
图片沿用上传时解码、去元数据及最长边1024的PNG规范化,不在读取时生成新封面、重传或裁切。主页photos[].id是不可变文件编号,position是已审公开顺序,两者独立;没有额外宽高、缩略图或版本查询。客户端解码固有尺寸,缩略图按UI裁切,大图保持原比例。
失败响应¶
| HTTP | code | 处理 |
|---|---|---|
| 400 | BAD_REQUEST/INVALID_CLIENT_HEADERS | UUID或公共头不合法 |
| 401 | UNAUTHORIZED | 匿名、失效凭据、安装/渠道不一致或已退出 |
| 403 | FORBIDDEN/ACCOUNT_DISABLED | 查看者角色、账号或注册/VIP准入不满足 |
| 404 | NOT_FOUND | 目标不可见/屏蔽、未审/撤下/替换的引用、跨用户/暂存/软删除图片,或实际文件不可读 |
| 426 | HTTPS_REQUIRED | 当前模式要求安全传输 |
| 503 | SERVICE_UNAVAILABLE | 必要数据库等依赖不可用 |
| 500 | INTERNAL_ERROR | 未预期读取失败 |
失败沿用标准code/message/data/errors及真实HTTP状态;请求只接受image/png时,错误可能按媒体协商返回无正文406,客户端仍不得当成功。建议统一媒体层接受图片及application/json以读取业务错误。媒体错误不以默认照片、成功空字节或空相册替代,保持本照片位置和重试能力。
OSS直接读取¶
2026-11-20统一媒体交付已部署到唯一正式环境(运行配置仍为dev):App直接使用原资料/列表JSON中的地址与统一mediaDelivery,无需能力头,服务端选择CDN/OSS/API,详情见统一媒体交付。批量下载授权仅用于按业务path重新授权;默认头像等内置资源显式API模式。本页GET及其Bearer、公共头和no-store规则继续保留,二进制正文不被JSON投影,不自动重定向。
接入说明¶
每次GET在只读REPEATABLE_READ快照内重新核对当前公开引用。审核下架、清空、替换或账号注销后,后续请求即不可读;已保存到设备的旧副本不会由HTTP自动抹除。缓存按登录身份隔离,退出/换号清理授权缓存,敏感图片不能以公共URL外发或脱离当前权限复用。
头像继续走独立用户头像入口,按Bearer读取本人绑定/他人已审值;本路径的自看规则始终是公开相册。动态图片仍按原动态媒体契约,不使用相册编号发布或绕过先审。
2026-11-11服务器完整clean verify通过1018项,0失败/错误/跳过;新增公开相册专项16项在隔离合成账号中覆盖待审/通过/驳回/下架、旧图保留及替换、九张顺序与空位、清空、暂存及跨归属、元数据故障与实际文件丢失、双向屏蔽/失活、认证/安装/公共头/准入,以及独立用户动态。JSON经真实HTTP/JWE,图片按真实PNG/no-store/免JWE检查,业务写入与审核仅在隔离库;开发版本20261111-user-profile-014053已发布;真实dev HTTP入口24项通过,包括合成账号自看主体及4张当前已审照片的PNG、真实字节数、no-store及nosniff核对,错误入口和退出后失效通过。运行资料、公开相册及访客摘要保持,验收会话已退出;未读取截图目标或为验收新增访客/关注/会员。客户端浏览、四语读屏、加载失败重试及设备验收由Flutter任务完成。