简要描述:
- 获取下载文件列表
通过本接口可以帮助您创建下载任务。支持通过文件ID和文件夹ID,获取可下载文件的递归目录信息。
返回值中的 path 为对应当前文件目录的相对位置。需要在您设计的软件中,本地自动创建文件夹,并把文件下载至对应的文件夹内。这样可以保持与服务端一样的文件结构。
接口版本:
版本号 | 制定人 | 制定日期 | 修订日期 |
---|---|---|---|
1.0 | Joe | 2020-05-20 | 2020-05-20 |
请求URL:
请求参数:
参数名 | 是否必须 | 类型 | 说明 |
---|---|---|---|
ids | 是 | array(string) | 需要下载的文件/文件夹ID,文件以f开头,文件夹以d开头 |
请求示例:
POST /v1/private/file/download HTTP/1.1
HOST: rest.ctfile.com
content-type: application/json
content-length: 89
{
"session": "ff6cf1d8b56c41d1da684ea3bc3df6eb",
"ids": [
"f787983138"
]
}
返回示例:
正常返回:
{"code":200,"results":[{"key":"f787983138","icon":"apk","userid":10741048,"name":"\u9884\u8a00\u5bb61.7(\u5fc3\u67d4\u7834\u89e3).apk","size":3117964,"path":"\/"}]}
错误时返回:
{"code":403,"message":"错误描述"}
返回参数说明:
参数名 | 类型 | 说明 |
---|---|---|
key | string | 文件ID |
icon | string | 文件图标 |
name | string | 文件名称 |
size | long | 文件大小(bytes) |
path | string | 为对应当前文件目录的相对位置。需要自动创建文件夹,并把文件下载至对应的文件夹内。 |
备注:
- 更多返回错误代码请看首页的错误代码描述
文档更新时间: 2021-04-30 22:59 作者:admin