获取文件列表

[隐藏]

目录

1.接口说明

        获取指定的文件夹下的子文件和文件夹列表。

2.接口URL

        http://api.cloud.189.cn/listFiles.action

3.支持格式

        xml

4.HTTP请求方式

        GET

5.请求Headers


字段标识 说明 数据类型 长度(字节) 可空
AccessToken OAuth2 Access Token String N
Signature 请求签名 String N
Date 请求日期和时间。例如：Wed, 01 Mar 2009 12:00:00 GMT String N

6.请求参数


字段标识 说明 数据类型 长度(字节) 可空
folderId 文件夹ID，为空时，返回应用默认文件夹下的文件列表 Long N
fileType 文件类型选项 0或空：不限 1：只限文件 2：只限文件夹 Integer N
mediaType 文件媒体类型选项 0或空：不限 1：只限图片 2：只限音乐 3：只限视频 4：只限文档 Integer N
mediaAttr 文件媒体属性选项 0或空：不获取 1：获取 Integer N
iconOption 获取文件缩略图选项 0或空-不获取缩略图 1：获取小尺寸缩略图(80max) 2：获取中尺寸缩略图(160max) 4：获取大尺寸缩略图(320max) 8 ：600max缩略图 各种尺寸缩略图选项可采用叠加方式同时存在 Integer N
orderBy 文件列表排序方式： filename：按照文件名称排序 filesize：按照文件大小排序 createDate：按照文件生成时间排序 lastOpTime：按照文件最后操作时间排序 String N
descending 是否降序排列： true：按照降序排列 空或false：按照升序排列 Booolean N
pageNum 获得结果集的页码，从1开始 Integer N
pageSize 获得结果集的分页大小 Integer N

7.请求样例 

GET /listFiles.action HTTP/1.1

Host: api.cloud.189.cn

Date: date

AccessToken: key

Signature: signature

8.返回参数


字段标识 说明 数据类型 长度(字节) 可空
listFiles 文件列表结果元素容器 Container N
—lastRev 用户存储最新版本号 Long N
—fileList 文件列表元素容器 Container N
——count 子文件夹和子文件文件总数量 Integer N
——folder 子文件夹元素容器，0到多个 Container N
——file 子文件元素容器，0到多个 Container N


9.返回样例 

正确返回样例：20110324090081文档2009-02-06 12:00:002009-02-06 12:00:0020090206120000100测试.txt10241F3870BE274F6C49B3E31A0C6728957F2011-03-24 09:00:002011-03-24 09:00:0020110324090000


错误返回样例：无

10.其它

        无