weiyun_get_pic_thumb

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

1.接口说明

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

2.使用场景

3. 接口调用说明

3.1请求说明

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

3.2输入参数说明

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

参数名称是否必须类型描述
file_id必须string待下载文件的ID，字符串（68字节）
thumb必须string缩略图尺寸，string。目前支持四种类型: 
1024*1024，640*640，128*128，64*64

3.3请求示例

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

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

 

3.4返回参数说明

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

data数据说明

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

 

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,
"dl_thumb_size":128*128
},
"ret":0
}

 

3.7 错误返回示例

JSON示例：

{
"ret":201052
}

4.相关问题

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