获取文件信息
1.接口说明
获取指定的文件信息。
2.接口URL
http://api.cloud.189.cn/getFileInfo.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.请求参数
注:fileId或filePath,至少有一个必须非空;如果都存在,fileId参数有效。
字段标识 | 说明 | 数据类型 | 长度(字节) | 可空 |
---|---|---|---|---|
fileId | 文件ID | Long | N | |
folderPath | 文件夹路径,以 / 分隔 | String | N | |
mediaAttr | 文件媒体属性选项 0或空:不获取 1:获取 | Integer | N | |
iconOption | 获取文件缩略图选项 0或空-不获取缩略图 1:获取小尺寸缩略图(80max) 2:获取中尺寸缩略图(160max) 4:获取大尺寸缩略图(320max) 8 :600max缩略图 各种尺寸缩略图选项可采用叠加方式同时存在 | Integer | N |
7.请求样例
GET /getFileInfo.action HTTP/1.1
Host: api.cloud.189.cn
Date: date
AccessToken: key
Signature: signature
8.返回参数
字段标识 | 说明 | 数据类型 | 长度(字节) | 可空 |
---|---|---|---|---|
fileInfo | 文件信息元素容器 | Container | N | |
—id | 文件Id | Long | ||
—parentFolderId | 父文件夹Id | Long | ||
—path | 文件路径 | String | ||
—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 | ||
—fileDownloadUrl | 文件下载地址 | String | ||
—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.返回样例
正确返回样例: 100-11/我的文档/测试文档/测试.txt测试.txt10241F3870BE274F6C49B3E31A0C6728957F2011-03-24 09:00:002011-03-24 09:00:0020110324090000
错误返回样例:无
10.其它
无