1. 接口说明

文件上传申请，成功会返回实际上传的地址。

根据申请上传返回的地址，组织数据上传。

1.1 URL

OAuth2.0协议： https://graph.qq.com/weiyun/upload_file

OAuth1.0协议： http://openapi.qzone.qq.com/weiyun/upload_file

1.2 格式

JSON

1.3 HTTP请求方式

GET

1.4 输入参数说明

各个参数请进行URL编码，编码时请遵守RFC 1738

a) 通用参数

OAuth2.0协议必须传入的通用参数，详见这里

OAuth1.0协议必须传入的通用参数，详见这里

b) 私有参数

appid: 第三方接入ID

sha : 待上传文件对应的SHA1的值(使用SHA1算法)

md5 : 待上传文件对应的MD5值

size : 文件大小，单位为字节

name : 文件名，字符串(中文名称用UTF8格式编码，文件名规则跟windows系统一样，文件名中不能包括下列字符 \ / : * ? ” < > | )

upload_type:上传类型，可选。control:控件上传(默认)，normal:普通http上传。数据的上传方式一定要填写正确，不然不能正确上传，因为不同的上传方式，返回的上传服务器是不一样

1.5 请求示例

以OAuth2.0协议为例(敏感信息都用*号进行了处理，实际请求中需要替换成真实的值)：

https://graph.qq.com/weiyun/put?

access_token=*************&

oauth_consumer_key=12345&

openid=****************

1.6 返回参数说明

ret: 操作结果，参见“返回错误码具体含义”

file_id:待上传文件的文件ID(68字节长度的字符串)

sum:上传校验码，字符串(最大348字节)

port:上传服务器端口

host: 上传服务器地址或者域名

1.7 返回码说明

0: 正确返回

1013: 存储平台系统繁忙

1014: 业务内部错误

1015: 在存储平台创建用户失败

1016: 存储平台不存在该用户

1019: 目录不存在

1022: 文件已经存在

1023: 上传文件时，索引创建成功，上传地址获取失败，客户端需要发起续传

1025: 访问bitmap失败

1026: 父目录不存在

1028: 目录或者文件数超过总限制

1029: 单个文件大小超限

1051: 当前目录下已经存在同名文件

1053: 用户剩余空间不足

1057: 续传时源文件已经发生改变

1071: oidb 数据库访问失败

1072: oidb 数据头部校验失败

1076: 非法文件，文件在黑名单中

1078: 用户不在白名单中

20008: 接入服务内部错误

20014: 该APPID不存在

20015: 认证key错误

30003: 缓冲区长度不够

100003: 文件的SHA值无效

100004: 文件的MD5值无效

100006: 内存溢出

100009: 内部通讯错误

100013: 初始化ptlogin失败

100014: ptlogin验证失败

100017: appid无效

100018: 上传类型无效

100019: 父目录无效

1.8 正确返回示例

JSON示例:

{

"data": {

"csum": "32e5cdf9c5452488c92180d0b03b5b04335b3b09b9f057f2313e996b340ca7f425176d9dc89401c3fddc0f7cec6b96c65b9c287b76891b3f51e89871e21470dc39ef3098923bba74288fb65ba97b2b5ff7cc21460fe3d8a295c629c9d64de9e7fbcae2dc43f375151741d0ad82a42b9c3eaa6282f943ee378e3ef2e380a2c5d22dd0504b3448ddff470b346ef1dd55b0e4d98b51f3859ed74da81d43ff68d59d61def6c08ed98d9bdd8c18de89fce6907d301446cd8029ea7c6328d78cf892b4ed9e08cee74561cf27f1196ac13c2e6468ad6706b0c6b5bb78f2cc6d9d6ba9864167214f10020c4347cc9cc81b21006b54f91e8cfb9c8a6df850199e8794fa28ec1a4d78d4e9ed8208bd40836618eb3ab13d7f5840d31cfa0932768d599d1696f8b25c60a2389e28b75ed4af0d014255",

"file_id": "8fb2cfad-67a9-49a8-b6b1-40014b57dbd7",

"host": "hz.qqdisk.ftn.qq.com",

"port": 80

},

"ret": 0

}

1.9 错误返回示例

{

"data": {

"file_attr": "3",

"file_ctime": "1970-01-16 20:13:29 458",

"file_cur_size": "0",

"file_id": "bb58fc0e-af02-454b-81ed-c1dfcecfa596",

"file_md5": "076e3caed758a1c18c91a0e9cae3368f",

"file_name": "d1.jpg",

"file_sha": "f5f8ad26819a471318d24631fa5055036712a87e",

"file_size": "879394",

"pdirkey": "4b7c321637e8951db1089abfc006961",

},

"ret": 1051

}