文件搜索

[隐藏]

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.其它