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

获取用户云下载任务列表

基本信息

属性	内容
接口名称	获取用户云下载任务列表
接口版本	v1.0
接口路径	/get_task_list
请求方法	GET
接口状态	生产环境

接口说明

分页获取当前授权用户的云下载任务列表。

接口地址

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

请求方式

GET

认证方式

Authorization: Bearer access_token

请求参数

参数名	类型	必填	默认值	说明	约束/示例
page	int	否	1	页码	1

请求示例

curl -G 'https://proapi.115.com/open/offline/get_task_list' \
  -H 'Authorization: Bearer <access_token>' \
  --data-urlencode 'page=1'

响应字段说明

字段	类型	描述
state	boolean	状态，true表示成功
message	string	返回信息
code	int	错误码
data	object	分页任务数据
data.page	int	当前页码
data.page_count	int	总页数
data.count	int	任务总数
data.tasks	object[]	云下载任务列表
data.tasks[].info_hash	string	任务SHA1
data.tasks[].add_time	int	任务添加时间戳
data.tasks[].percentDone	int	任务下载进度
data.tasks[].size	int	任务总大小，单位为字节
data.tasks[].name	string	任务名称
data.tasks[].last_update	int	任务最后更新时间戳
data.tasks[].file_id	string	任务源文件或文件夹ID
data.tasks[].delete_file_id	string	删除任务并删除源文件时需传递的文件或文件夹ID
data.tasks[].status	int	任务状态，见下方枚举表格
data.tasks[].url	string	链接任务URL
data.tasks[].wp_path_id	string	任务源文件所在父文件夹ID
data.tasks[].def2	int	视频清晰度，见下方枚举表格
data.tasks[].play_long	int	视频时长
data.tasks[].can_appeal	int	是否可以申诉

响应的 data.tasks[].status 字段枚举

值	说明	备注
-1	下载失败	-
0	分配中	-
1	下载中	-
2	下载成功	-

响应的 data.tasks[].def2 字段枚举

值	说明	备注
1	标清	-
2	高清	-
3	超清	-
4	1080P	-
5	4K	-
100	原画	-

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

错误码	说明	解决方案
990002	参数错误	检查授权信息

响应示例

{
  "state": true,
  "message": "",
  "code": 0,
  "data": {
    "page": 1,
    "page_count": 0,
    "count": 0,
    "tasks": []
  }
}

业务规则

• 未传 page 或参数值为空时，默认查询第1页。

性能与安全说明

• 用户身份由 Bearer access_token 解析，请求参数不能指定115账号。
• 接口按应用、用户和接口维度执行频率限制。
• 任务列表按 page 分页，实际返回数量以响应为准。

注意事项

• 云下载任务状态和字段以响应中的 data 字段为准。

修改历史

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