取消未确认的OSS上传¶
请求参数¶
八项公共请求头全部必填,Bearer与当前安装绑定。注册中账号也可取消本人意图。正式环境HTTPS,JSON响应遵循统一JWE。只有路径uploadId(必填UUID);无查询参数、无请求体。
只能取消未确认意图,可重复调用。取消不撤销已签发PUT URL,因此上传仍可能在到期前完成,但后端不再允许确认,不生成业务媒体ID;签名到期后一小时才回收对象,防止旧URL重建。已确认媒体须用原业务discard或保存移除,不能经此入口删除正式媒体。
请求示例¶
curl -X DELETE 'https://api.budyoo.cn/api/v1/media/uploads/22222222-2222-4222-8222-222222222222' \
-H 'Accept: application/json' -H 'Accept-Language: zh-CN' \
-H 'Authorization: Bearer <accessToken>' \
-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: 4d4ae3ea-6a4a-4f34-a292-8e94551851d7' \
-H 'X-Request-Id: 632e403d-fbf8-43a1-8dc6-d87c20371a2e' \
-H 'X-Request-Timestamp: <当前Unix毫秒>'
成功响应¶
HTTP 200,data=null。
{"code":"SUCCESS","message":"操作成功。","data":null,"errors":[]}
响应只表示取消事实已提交,不表示对象已经物理删除。
失败响应¶
| HTTP | code | 处理 |
|---|---|---|
| 401 | UNAUTHORIZED | 重新登录,不把原意图交给新账号 |
| 404 | NOT_FOUND | 不存在或非本人 |
| 409 | UPLOAD_CONFLICT | 已确认,使用原业务删除入口 |
| 503 | SERVICE_UNAVAILABLE | 持久化依赖不可用,不声明取消成功 |
{"code":"UPLOAD_CONFLICT","message":"上传状态已变化,请先确认结果再重新操作。","data":null,"errors":[]}
接入说明¶
本接口只操作申请意图,与上传确认共用账号和意图锁。注销在账号事务中清空意图归属与回执,并保留无身份的待回收UUID;晚到确认不能创建媒体。原始对象按用途目录回收,失败留行重试;此接口无桶管理、批量删除或公开资源操作能力。2026-11-16服务器回归通过,覆盖重复取消、跨账号拒绝、JWE、注销清空归属、签名宽限及删除失败重试;真实客户端及设备验收另行记录。