weiyun_upload_pic

特别提示：
出于信息安全的考虑，本接口仅对可信赖的合作网站开放。
已经成功接入"QQ登录"的网站需提交申请以获取访问本接口的使用权限。

1.接口说明

申请照片文件上传，获取其上传地址、端口、申请到的文件ID、上传校验码等信息。

2.使用场景

3. 接口调用说明

3.1请求说明

url	https://graph.qq.com/weiyun/upload_photo
支持验证方式	oauth2.0
格式	JSON
http请求方式	GET，POST
是否需要鉴权	需要
接口调试	点击这里测试

3.2输入参数说明

各个参数请进行URL 编码，编码时请遵守 RFC 1738。
（1）通用参数
OAuth2.0协议必须传入的通用参数，详见这里。
（2）私有参数

参数名称	是否必须	类型	描述
sha	必须	string	待上传文件SHA
md5	必须	string	待上传文件MD5
size	必须	unsigned int	待上传文件size字节
name	必须	string	待上传文件名
upload_type	可选	string	normal，默认control

3.3请求示例

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

https://graph.qq.com/weiyun/upload_photo?
access_token=*************&
oauth_consumer_key=12345&
openid=****************&
sha=725ad425e4b83580fd0b83d5771fdc1548aadccb&
md5=e2d751f95bbc508e623f4ef93711b216&
size=15034978&
name=myvideo.mp5&
upload_type=control

3.4返回参数说明

参数说明	描述
ret	返回码
msg	如果ret<0，会有相应的错误信息提示，返回数据全部用UTF-8编码。
data	json格式的返回数据

data数据说明

参数说明	描述
file_id	待上传文件的ID，字符串（68字节）
sum	上传校验码，字符串（最大348字节）
port	上传服务器端口，整型
host	上传服务器地址或域名，字符串

3.5返回码说明

0: 正确返回
其它: 失败。错误码说明详见：公共返回码说明。
微云私有返回码请参考《微云对外接口描述文档.doc》

3.6 正确返回示例

JSON示例：

{"data":{
"csum":"4a35323b288300d69fb834d9b37b0448614cf7a8734648092e",
"file_id":"c5c026a72a157dd36207e3564b592014052495ac-697f-42d7-94d8-9dfff4127cd3"，
"host":"xa.yunup.ftn.qq.com",
"port":80
},
"ret":0
}

3.7 错误返回示例

JSON示例：

{
"ret":200003
}

4.相关问题

你可以直接通过我们的支持系统查看更多问题或提问，也可以直接联系我们的在线客服，企业QQ：800030681