REST API定义

[隐藏]

1.通用请求头

Header名称描述必要性
AccessTokenOAuth2 Access Token必要
Date请求日期和时间。例如:Wed, 01 Mar 2009 12:00:00 GMT   类型:String 默认值:无必要
Host用于指定被请求资源的Internet主机和端口号,通常从请求HTTP URL中自动提取 类型:String 默认值:无必要
Content_Length消息(不包括头部)长度 类型:String 默认值:无条件
Content-Type内容媒体类型,如text/plain 类型:String 默认值:无可选
EDrive-BaseFileId要修改的源文件Id 类型:String 默认值:无条件
Edrive-FileMD5文件MD5码 类型:String 默认值:无条件
Edrive-FileName上传文件名 类型:String 默认值:无条件
Edrive-FileLength上传文件数据实际长度 类型:String 默认值:无条件
Edrive-UploadFileId断点续传文件Id 类型:String 默认值:无条件
Edrive-ParentFolderId上传文件父目录Id 类型:String 默认值:无条件
Signature请求签名 类型:String 默认值:无条件

2.通用响应头

Header名称

描述
Content-Length 响应体字节长度(不包括头部)。 类型:String 默认值:无
Connection 指明与服务端的当前连接状态为open或close。 类型:String 默认值:无
Date 响应日期和时间。例如:Wed, 01 Mar 2009 12:00:00 GMT 类型:String 默认值:无
Server 产生响应的服务器名称。 类型:String 默认值:无

3.请求签名

Signature=hmac_sha1(“AccessToken=相应的值&Operate=相应值&RequestURI=相应值&Date=相应的值”, AppSecret)

AccessToken:OAuth2 Access Token

AppSecret:应用Secret

Operate:HTTP请求方法,如“PUT”、“GET”或“DELETE”字符串

RequestURI:HTTP请求资源路径

Date:请求时间

4.用户接口


获取用户基本信息(点击查看)http://api.cloud.189.cn/getUserInfo.action
获取用户扩展信息(点击查看)http://api.cloud.189.cn/getUserInfoExt.action
上传用户头像(点击查看)http://api.cloud.189.cn/uploadUserHeadPortrait.action
设置用户扩展信息(点击查看)http://api.cloud.189.cn/updateUserInfoExt.action

5.文件接口


获取文件列表(点击查看)http://api.cloud.189.cn/listFiles.action
获取文件夹信息(点击查看)http://api.cloud.189.cn/getFolderInfo.action
获取文件信息(点击查看)http://api.cloud.189.cn/getFileInfo.action
文件搜索(点击查看)http://api.cloud.189.cn/searchFiles.action
获取文件下载地址(点击查看)http://api.cloud.189.cn/getFileDownloadUrl.action
批量获取文件下载地址(点击查看)http://api.cloud.189.cn/batchGetFileDownloadUrl.action
创建文件夹(点击查看)http://api.cloud.189.cn/createFolder.action
上传并创建文件(一次性PUT上传)(点击查看)http://upload.cloud.189.cn/uploadFile.action
创建上传文件(断点续传)(点击查看)http://api.cloud.189.cn/createUploadFile.action
获取上传文件状态(断点续传)(点击查看)http://api.cloud.189.cn/getUploadFileStatus.action
上传文件数据(断点续传)(点击查看)使用创建上传文件接口和获取上传文件状态接口响应中的确认文件上传完成URL
确认上传文件完成(断点续传)(点击查看)使用创建上传文件接口和获取上传文件状态接口响应中的确认文件上传完成URL
重命名文件夹(点击查看)http://api.cloud.189.cn/renameFolder.action
重命名文件(点击查看)http://api.cloud.189.cn/renameFile.action
复制文件(点击查看)http://api.cloud.189.cn/copyFile.action
移动文件夹(点击查看)http://api.cloud.189.cn/moveFolder.action
移动文件(点击查看)http://api.cloud.189.cn/moveFile.action
删除文件夹(点击查看)http://api.cloud.189.cn/deleteFolder.action
删除文件(点击查看)http://api.cloud.189.cn/deleteFile.action

6.分享接口


生成文件分享链接(点击查看)http://api.cloud.189.cn/createShareLink.action

7.营销接口


用户签到检查(点击查看)http://api.cloud.189.cn/mkt/userSignCheck.action
用户签到(点击查看)http://api.cloud.189.cn/mkt/userSign.action