简要描述:
- 获取指定的文件和文件夹列表。
通过本接口可以通过文件和文件夹编号获取指定的文件信息。
接口版本:
版本号 | 制定人 | 制定日期 | 修订日期 |
---|---|---|---|
1.0 | Joe | 2020-05-20 | 2020-05-20 |
请求URL:
请求参数:
参数名 | 是否必须 | 类型 | 说明 |
---|---|---|---|
ids | 是 | array(string) | 需要操作的文件/文件夹ID,文件以f开头,文件夹以d开头 |
onlyFiles | 否 | int | 1:只显示文件不显示文件夹,0:全部显示(默认) |
请求示例:
POST /v1/public/file/ids_list HTTP/1.1
HOST: rest.ctfile.com
content-type: application/json
content-length: 107
{
"session": "41e20167a3b05a21c47265dd3c262c92",
"ids": [
"f229307016",
"d31688206"
]
}
返回示例:
正常返回:
{"code":200,"results":[{"key":"d31688206","icon":"folder","name":"\u89c6\u9891\u683c\u5f0f","date":1545278903,"status":1},{"key":"f229307016","icon":"file","name":"DELL 3050 Win7 64 IE8.gho","imgsrc":"","size":12954629366,"date":1511345168,"status":1}]}
错误时返回:
{"code":403,"message":"错误描述"}
返回参数说明:
参数名 | 类型 | 说明 |
---|---|---|
key | string | 文件ID |
icon | string | 文件图标 |
imgsrc | string | 视频/图片的缩略图URL |
name | string | 文件名称 |
size | long | 文件大小(bytes) |
date | timestamp | 文件上传时间 |
status | int | 1: complete, 2: incomplete。如果为2,属于incomplete的状态,那请添加个未完成的icon(未完成的文件不支持下载、打包、解压) |
备注:
- 更多返回错误代码请看首页的错误代码描述
文档更新时间: 2021-04-30 22:58 作者:admin