创建上传文件(断点续传)
1.接口说明
创建一个上传文件用于保存断点续传的文件。
2.接口URL
http://api.cloud.189.cn/createUploadFile.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.请求参数
字段标识 | 说明 | 数据类型 | 长度(字节) | 可空 |
---|---|---|---|---|
parentFolderId | 父文件夹ID,为空时,上传文件父目录为应用默认文件夹 | Long | N | |
baseFileId | 要修改的源文件Id | Long | N | |
filename | 创建的上传文件名称 | String | N | |
size | 上传文件大小(字节) | Long | N | |
md5 | 上传文件的MD5码 | String | N | |
lastWrite | 源文件的最后修改时间(YYYY-MM-DD hh:mm:ss) | String | N | |
localPath | 源文件的全路径 | String | N |
7.请求样例
POST /createUploadFile.action HTTP/1.1 Host: api.cloud.189.cn Date: date AccessToken: key Signature: signature parentFolderId=1234&baseFileId=& ilename=test.txt &size=113&md5=0C6DF11EA5072E781FEF0C3D1D7441A8 &lastWrite=2012-07-09+06%3a56%3a51.302 &localPath=E%3a%5cecloud%5c18926128616%5ctest3.txt
8.返回参数
字段标识 | 说明 | 数据类型 | 长度(字节) | 可空 |
---|---|---|---|---|
uploadFile | 上传文件元素容器 | Container | N | |
—uploadFileId | 用于断点续传的临时文件Id | Long | ||
—fileUploadUrl | 文件上传URL | String | ||
—fileCommitUrl | 确认文件上传完成URL | String | ||
—fileDataExists | 0或空 – 文件数据不存在 1 – 文件数据已存在,无需上传数据,可以确认上传完成 | Integer |
9.返回样例
正确返回样例:29909576http://upload.cloud.189.cn/uploadFileData.actionhttp://upload.cloud.189.cn/commitUploadFile.action0
错误返回样例:无
10.其它
无