DELETE/api/v1/media/uploads/{uploadId}
App Bearer、八项公共头、本人上传意图JSON 响应接入指南 ↗

取消未确认的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、注销清空归属、签名宽限及删除失败重试;真实客户端及设备验收另行记录。