按登录身份读取用户头像¶
请求参数¶
路径userId为目标UUID,ROLE_USER及公共头必填。仅活跃且资料完成的目标可读;服务器将当前Bearer认证的userId与路径userId比较,选择下述头像,不接收客户端指定查看身份或头像编号。双向屏蔽、目标不存在或不可用404;本入口不读取未绑定的暂存头像或相册。成功image/png文件字节,不套JSON/JWE,不带X-Budyoo-Encryption或X-Budyoo-JWE;正式HTTPS。
所有调用发送八项公共头,app/android或ios及当前包渠道,安装ID与会话一致。未知字段拒绝或按本文明确范围处理,身份只来自Bearer。媒体不使用JSON加密。当前固定码dev仅供隔离账号联调,prod禁止HTTP和固定码。message四语,缺省/未知语言英文,code不翻译。
请求示例¶
以下方法路径为契约,UUID/数据为合成示例;通过既有统一客户端发送动态语言、完整元数据和Bearer,禁止记录凭据。
await api.request({path: '/api/v1/media/user-avatars/11111111-1111-4111-8111-111111111111', method: 'GET'});
统一层必须提供Accept-Language、X-Client-Type=app、X-Platform、X-App-Version、X-App-Build、X-Channel、持久X-Device-Id及每次新X-Request-Id/X-Request-Timestamp,Authorization按当前会话注入。
成功响应¶
HTTP200,Content-Type:image/png及Cache-Control:no-store,正文为服务器按当前登录身份选择的PNG字节。
| 查看身份与状态 | 返回图片 |
|---|---|
| 本人查看自己,已有保存绑定 | 最新已保存绑定的头像,包括待审、驳回及已下架状态 |
| 本人只上传尚未保存绑定 | 仍用原绑定头像;原本没有绑定则使用默认图 |
| 其他人查看,有仍公开的已审头像 | 最后审核通过的公开头像;新候选待审或驳回时保留原公开图 |
| 本人无绑定,或他人查看时无公开头像 | 资料gender为male/female时返回正式男/女默认图,缺省或历史未知性别返回中性Budyoo Logo |
| 用户主动清空头像 | 本人与他人均返回默认图,即使仍有历史上传文件 |
最新指当前资料成功保存的绑定,不按上传时间、未提交表单或审核队列时间挑选。存在引用但文件缺失时沿用读取错误,不返回默认图或回退旧图片。JSON公开资料中的avatarId仍为已审引用,不保证与本人通过本入口读取的图片相同。
成功字段和单次操作语义见请求参数,创建或保存失败不返回伪造成功对象。
失败响应¶
| HTTP | code | 处理 |
|---|---|---|
| 400 | BAD_REQUEST/VALIDATION_FAILED/INVALID_CLIENT_HEADERS | 参数或公共头不合法 |
| 401 | UNAUTHORIZED | 无效凭据、安装不一致或会话已撤销 |
| 403 | FORBIDDEN/ACCOUNT_DISABLED/VIP_REQUIRED | 按角色、账号状态及VIP准入处理 |
| 404 | NOT_FOUND | 目标不存在、资料未完成、已停用/注销或双向屏蔽 |
| 426 | HTTPS_REQUIRED | 当前模式要求安全传输 |
| 503 | SERVICE_UNAVAILABLE | 依赖或投递不可用,不伪装成功 |
各错误仅在对应操作适用;加密失败沿用公共协议。写请求超时不等于没有执行,不自动盲目重试敏感操作。
OSS直接读取¶
2026-11-20统一媒体交付已部署到唯一正式环境(运行配置仍为dev):App直接使用原资料/列表JSON中的地址与统一mediaDelivery,无需能力头,服务端选择CDN/OSS/API,详情见统一媒体交付。批量下载授权仅用于按业务path重新授权;默认头像等内置资源显式API模式。本页GET及其Bearer、公共头和no-store规则继续保留,二进制正文不被JSON投影,不自动重定向。
接入说明¶
头像统一读取响应中的avatarUrl,兼容模式地址为/api/v1/media/user-avatars/{userId}。媒体请求的Bearer身份与目标相同时返回本人最新已保存、已绑定的头像,待审、驳回或下架也能本人查看;其他查看者只返回最后审核通过且仍公开的头像。各自没有对应头像引用时才按资料性别返回男/女默认PNG,未知性别使用中性Budyoo Logo;仅上传未保存绑定不生效,文件读取失败保持错误。公开资料的avatarId仍只表示已审引用,可能为null或旧编号,客户端始终直接加载avatarUrl,不据此跳过图片或改选素材。原鉴权、公共头、账号准入、双向屏蔽及no-store规则保持,缓存须隔离登录身份并在本人头像保存后失效。
评论、二级回复、动态、评论预览、关系列表、公开资料及明信片中已有avatarUrl统一遵循本入口,无需前端区分页面或增加参数。公开昵称、个性签名与avatarId字段仍使用最后审核通过值,关系昵称搜索也不匹配未审草稿;仅本人通过头像媒体入口可读取自己的绑定图,具体见资料审核。
本人UI以真实返回为准,失败保留输入并显示重试;只有成功空结果可显示空态,不以设计昵称、余额、列表补数据。切换账号或退出后取消旧请求,迟到响应不能写入新会话。
2026-11-10服务器完整回归覆盖888项,既有875项通过;新增13项按查看身份选择头像的专项在修正测试临时目录后复验全部通过,最终报告无失败/错误/跳过。覆盖本人待审/驳回/通过/下架、无绑定及暂存不生效、像素不同的新旧头像、保存绑定/清空、他人保留旧公开图、评论与二级回复/动态/预览/关系/明信片、伪造身份参数、安装/公共头/注册/VIP/退出,以及文件缺失不回退默认。JSON使用真实HTTP控制器与JWE,媒体核对实际PNG字节及no-store;只操作隔离合成账号,不代表客户端或真机验收。