weiyun_download_pic

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

1.接口说明

申请照片文件下载，获取其下载url、host、端口、cookie等信息。

2.使用场景

3. 接口调用说明

3.1请求说明

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

3.2输入参数说明

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

参数名称	是否必须	类型	描述
file_id	必须	string	待下载文件的ID，字符串（68字节）

3.3请求示例

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

https://graph.qq.com/weiyun/download_photo?
access_token=*************&
oauth_consumer_key=12345&
openid=****************&
format=json&
file_id=c5c026a72a157dd36207e3564b592014052495ac-697f-42d7-94d8-9dfff4127cd3

3.4返回参数说明

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

data数据说明

参数说明	描述
dl_encrypt_url	加密url，字符串
dl_cookie_name	存储平台的cookie name，字符串
dl_cookie_value	存储平台的cookie value，字符串
dl_svr_port	下载服务器端口，整型
dl_svr_host	下载服务器地址或域名，字符串

文件的下载过程：
通过CGI从存储平台获取下载加密URL和COOKIE，然后拼装最终URL：

http://< dl_svr_host >:< dl_svr_port >/ ftn_handler/<dl_encrypt_url>/
"dl_encrypt_url":,	 //加密的URL
"dl_cookie_name":,	 //存储平台返回的cookie name
"dl_cookie_value":,	 //存储平台返回的cookie value
"dl_svr_port":,	 //下载服务器端口
"dl_svr_host":,	 //下载服务器地址或者域名，表示形式为文本
COOKIE中附加上：　dl_cookie_name＝dl_cookie_value
以HTTP GET方式进行下载，HTTP header具体如下：
GET /ftn_handler/dl_encrypt_url/ HTTP/1.1
Accept: */*
Accept-Language: zh-CN
User-Agent: Mozilla/4.0
Accept-Encoding: gzip, deflate
Host: dl_svr_host Connection: Keep-Alive
Cookie: dl_cookie_name=dl_cookie_value Pragma: no-cache
RANGE:bytes=startPos-endPos

注：其中RANGE:bytes=startPos-endPosrn，startPos指开始下载的位置，endPos指下载的末尾，中间的"-"不是减号，而是至的意思，请务必注意。如果下载整个文件，则为RANGE:bytes=0-rn或者没有RANGE域。

3.5返回码说明

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

3.6 正确返回示例

JSON示例：

{"data":{
"dl_cookie_name":"FTN5K",
"dl_cookie_value":"a891b2f9",
"dl_encrypt_url":"e042c314a585477d40ef9e7244af61e71d273539dca040cee8311cf593206f7c134c5008a2355f5e4e2dbdc3b9ac9db70091caaf3640cee51575f24607c1fb7d",
"dl_svr_host":"sz.yun.ftn.qq.com",
"dl_svr_port":80
},
"ret":0
}

3.7 错误返回示例