删除文件
更新时间:2026-11-13
DELETE
https://api.dumate.cn/api/dma/v1/files/{file_id}
本接口用于删除上传的文件(File)。
删除成功后返回被删除的文件标识;删除后再查询或下载该文件返回 404。
权限说明
使用 API Key 鉴权调用 API 流程,具体调用流程,请查看认证鉴权。
请求参数
Headers 参数
除公共头域外,无其它特殊头域
URL 参数
file_id
string
文件标识。
只能删除上传文件;会话产物(art_ 前缀)不允许删除,返回 400。文件不存在时返回 404。
必选
请求结构
DELETE /api/dma/v1/files/{file_id} HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>
示例代码
请求示例
curl --location --request DELETE "https://api.dumate.cn/api/dma/v1/files/node_g001a1c08f2357001N6XJI9EQ3cLNJr" \
--header 'Authorization: Bearer <YOUR_API_KEY>'
返回响应
Headers 参数
除公共头域外,无其它特殊头域
返回参数
type
string
资源类型标识,固定为 file_deleted。
可选
id
string
被删除的文件标识。
可选
响应示例
{
"type": "file_deleted",
"id": "node_g001a1c08f2357001N6XJI9EQ3cLNJr"
}
评价此篇文章
