文件搜索
1.接口说明
根据搜索条件获取指定的文件夹下符合搜索条件的子文件和文件夹列表。
2.接口URL
http://api.cloud.189.cn/searchFiles.action
3.支持格式
xml
4.HTTP请求方式
POST
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 | |
filename | 搜索文件名 | String | N | |
recursive | 递归标志 0或空:只搜索单层文件 1:递归搜索文件列表及子目录文件 | Integer | 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.请求样例
POST /searchFiles.action HTTP/1.1
Host: api.cloud.189.cn
Date: date
AccessToken: key
Signature: signature
folderId=123&filename=test
8.返回参数
注:返回文件列表中,文件夹总在文件前。
字段标识 | 说明 | 数据类型 | 长度(字节) | 可空 |
---|---|---|---|---|
file | 文件信息元素容器 | Container | N | |
—id | 文件Id | Long | ||
—name | 文件名称 | String | ||
—size | 文件大小 | Long | ||
—md5 | 文件的MD5码 | String | ||
—createDate | 文件夹创建日期(YYYY-MM-DD hh:mm:ss) | String | ||
—lastOpTime | 文件夹最后操作时间(YYYY-MM-DD hh:mm:ss) | String | ||
—mediaType | 文件媒体类型,0到1个 1:图片 2:音乐 3:视频 4:文档 | Integer | ||
—rev | 文件夹版本号 | Long | ||
—mediaAttr | 文件媒体属性元素容器,0个到多个 | Container | N | |
——streamKind | 媒体类型 | String | ||
——name | 媒体属性名称 | String | ||
——value | 媒体属性值 | String | ||
—icon | 文件夹缩略图元素容器,0到1个 | Container | N | |
——smallUrl | 小尺寸缩略图URL(80max) | String | ||
——mediumUrl | 中尺寸缩略图URL(160max) | String | ||
——largeUrl | 大尺寸缩略图URL(320max) | String | ||
——max600 | 600max缩略图 | String |
9.返回样例
正确返回样例:810testFolder2009-02-06 12:00:0020090206120000100test.txt10241F3870BE274F6C49B3E31A0C6728957F2011-03-24 09:00:002011-03-24 09:00:0020110324090000
错误返回样例:无
10.其它
无