创建上传文件(断点续传)

[隐藏]

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