MeBox/115doc/115开放平台/API列表/云下载/删除用户云下载任务.md

删除用户云下载任务

基本信息

属性	内容
接口名称	删除用户云下载任务
接口版本	v1.0
接口路径	/del_task
请求方法	POST
接口状态	生产环境

接口说明

删除当前授权用户的指定云下载任务，可选择同时删除对应源文件。

接口地址

https://proapi.115.com/open/offline/del_task

请求方式

POST
Content-Type: multipart/form-data

认证方式

Authorization: Bearer access_token

请求参数

参数名	类型	必填	默认值	说明	约束/示例
info_hash	string	是	-	需删除的任务Hash	<info_hash>
del_source_file	int	否	0	是否删除源文件，1=删除 0=不删除	0

请求示例

curl 'https://proapi.115.com/open/offline/del_task' \
  -H 'Authorization: Bearer <access_token>' \
  --form-string 'info_hash=<info_hash>' \
  --form-string 'del_source_file=0'

响应字段说明

字段	类型	描述
state	boolean	操作结果状态
message	string	返回信息
code	int	错误码
data	object[]	返回数据，成功时为空数组

响应的 code 字段(错误码)说明

错误码	说明	解决方案
990002	参数错误	检查 info_hash 参数

响应示例

{
  "state": true,
  "message": "",
  "code": 0,
  "data": []
}

业务规则

• 未传 del_source_file 时默认不删除源文件。
• del_source_file=1 会删除任务对应的源文件，操作前需确认影响范围。

性能与安全说明

• 用户身份由 Bearer access_token 解析，请求参数不能指定115账号。
• 接口按应用、用户和接口维度执行频率限制。

注意事项

• 删除结果以响应中的 state、code 和 message 字段为准。

修改历史

修改时间	修改说明
2025年04月01日(周二) 00:00:00	创建文档