简要描述:

  • 获取指定的文件和文件夹列表。
    通过本接口可以通过文件和文件夹编号获取指定的文件信息。

接口版本:

版本号 制定人 制定日期 修订日期
1.0 Joe 2020-05-20 2020-05-20

请求URL:

请求参数:

参数名 是否必须 类型 说明
ids array(string) 需要操作的文件/文件夹ID,文件以f开头,文件夹以d开头
onlyFiles int 1:只显示文件不显示文件夹,0:全部显示(默认)

请求示例:

POST /v1/private/file/ids_list HTTP/1.1
HOST: rest.ctfile.com
content-type: application/json
content-length: 105

{
  "session": "ff6cf1d8b56c41d1da684ea3bc3df6eb",
  "ids": [
    "f787983138",
    "d389861"
  ]
}

返回示例:

正常返回:

{"code":200,"results":[{"key":"d389861","icon":"folder","name":"\u4e66\u7c4d\u4e66\u7c4d","date":1473237859,"status":1},{"key":"f787983138","icon":"apk","name":"\u9884\u8a00\u5bb61.7(\u5fc3\u67d4\u7834\u89e3).apk","imgsrc":"","size":3117964,"date":1594442265,"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(未完成的文件不支持下载、打包、解压)

备注:

  • 更多返回错误代码请看首页的错误代码描述
文档更新时间: 2020-08-12 13:25   作者:admin