丢弃未保存的相册照片¶
请求参数¶
面向App,必须登录、完成注册并通过动态VIP准入。八项公共头全部必填,app/ios或android,安装UUID与会话绑定。正式要求HTTPS;当前dev仅隔离固定码账号允许明文HTTP。multipart/PNG及本媒体删除端点不使用JWE,身份和TLS要求不变。未完成注册返回403,待VIP返回403/VIP_REQUIRED。
公共头见请求头,四语见公共响应,加密见JWE协议。客户端类型和图片UUID本身不授予权限。
路径id必填,为图片UUID,必须归属目标用户且仍有效。无查询参数。 无业务请求体。 仅丢弃未绑定的有效照片;已在相册中的照片返回409/PHOTO_IN_USE,需要通过资料保存移除。删除为软删除,之后不可读取和重新绑定;磁盘文件物理清理尚未实现。
请求示例¶
示例UUID为合成数据;deviceId必须复用当前安装,不要每次新建。以下示例覆盖八项公共头;禁止日志输出Cookie或Bearer。
base_url='https://api.budyoo.cn' # 仅隔离开发账号;正式使用HTTPS
device_id='4d4ae3ea-6a4a-4f34-a292-8e94551851d7' # 当前会话对应安装
access_token='替换为当前开发会话'
curl --fail-with-body -X DELETE "$base_url/api/v1/media/album-photos/44444444-4444-4444-8444-444444444444" \
-H 'Accept-Language: zh-CN' \
-H 'X-Client-Type: app' -H 'X-Platform: android' \
-H 'X-App-Version: 1.0.0' -H 'X-App-Build: 1' -H 'X-Channel: dev' \
-H "X-Device-Id: $device_id" \
-H "X-Request-Id: $(uuidgen | tr '[:upper:]' '[:lower:]')" \
-H "X-Request-Timestamp: $(date +%s)000" \
-H "Authorization: Bearer $access_token"
成功响应¶
HTTP200,Cache-Control:no-store;合法请求ID回传。
{
"code": "SUCCESS",
"message": "操作成功。",
"data": null,
"errors": []
}
data固定null,errors为空数组。
失败响应¶
| HTTP | code | 条件 |
|---|---|---|
| 400 | BAD_REQUEST/VALIDATION_FAILED | 路径UUID、请求格式或必填参数不合法 |
| 400 | INVALID_CLIENT_HEADERS | 公共头缺失、重复或格式错误 |
| 401 | UNAUTHORIZED | 未登录、会话失效或安装不匹配 |
| 403 | FORBIDDEN/VIP_REQUIRED | 未完成注册或VIP准入未通过 |
| 404 | NOT_FOUND | 用户或归属范围内的图片不存在/已删除 |
| 426 | HTTPS_REQUIRED | 当前路径不允许明文HTTP |
| 503 | SERVICE_UNAVAILABLE | 数据库/Redis依赖暂不可用 |
| 409 | PHOTO_IN_USE/REGISTRATION_INCOMPLETE | 图片仍绑定相册,或目标未完成注册 |
| 400 | INVALID_PHOTO | 图片不存在、跨用户或已经软删除 |
| 403 | ACCOUNT_DISABLED | 目标账号被禁用 |
错误结构示例:
{"code":"UNAUTHORIZED","message":"按Accept-Language返回中文、英文、日文或韩文提示","data":null,"errors":[]}
未知或缺省语言回退英文;code不翻译。字段校验明细在errors[].field/message。网关可能先返回429/413,不能当成认证过的JWE业务响应。
接入说明¶
上传编号仅表示图片暂存成功;必须调用本人资料保存才能生效。放弃未绑定相册上传时可丢弃,丢弃不更改资料版本;已绑定照片通过资料保存移除。读取不公开、不支持其他用户查看,图片数据不写审计或日志。
已通过服务器隔离PostgreSQL/Redis完整整合272项回归,包含并行国家目录改动;本批24项覆盖30/31字符、鉴权、字段白名单、相册归属与九张上限、并发版本、两端真实JWE、后台CSRF和审计回滚。真实Servlet验证上传10MiB与超限,隔离Nginx另通过8项媒体路径大小检查。实现位于profile、media及admin/users模块,跨业务只走api契约。已随账号列表整合版本部署,V9已应用且媒体网关已更新;后台账号列表已接入头像读取,Flutter与后台资料编辑/相册页面尚未接入。完整278项服务器整合回归通过;本次公网浏览器核对列表及头像,其他新写接口的验收范围仍为服务器隔离测试。物理文件清理、公开图片分发、审核、好友、钱包和聊天不在本批范围。