get_vip_info
1 接口说明
获取已登录用户的关于QQ会员业务的基本资料。
基本资料包括以下信息:是否为“普通包月会员”,是否为“年费会员”,QQ会员等级信息,是否为“豪华版QQ会员”,是否为“钻皇会员”,是否为“SVIP”。
1.1 URL
OAuth2.0协议: https://graph.qq.com/user/get_vip_info
1.2 格式
JSON/XML
1.3 HTTP请求方式
GET/POST
1.4 输入参数说明
各个参数请进行URL 编码,编码时请遵守 RFC 1738
(1)通用参数
-OAuth2.0协议必须传入的通用参数,详见这里。
(2)私有参数
参数名称 | 是否必须 | 类型 | 描述 |
---|---|---|---|
format | string | 定义API返回的数据格式。 取值说明:为xml时表示返回的格式是xml;为json时表示返回的格式是json。 注意:json、xml为小写,否则将不识别。format不传或非xml,则返回json格式数据。 |
1.5 请求示例
以OAuth2.0协议为例(敏感信息都用*号进行了处理,实际请求中需要替换成真实的值):
https://graph.qq.com/user/get_vip_info?
access_token=*************&
oauth_consumer_key=12345&
openid=****************&
format=json
access_token=*************&
oauth_consumer_key=12345&
openid=****************&
format=json
1.6 返回参数说明
参数名称 | 描述 |
---|---|
ret | 返回码。 |
msg | 如果ret<0,会有相应的错误信息提示,返回数据全部用UTF-8编码。 |
is_qq_vip | 标识是否QQ会员(0:不是; 1:是)。 |
is_qq_year_vip | 标识是否为年费QQ会员(0:不是; 1:是)。 |
1.7 返回码说明
0: 正确返回
其它: 失败。错误码说明详见:公共返回码说明。
1.8 正确返回示例
JSON示例:
Content-type: text/html; charset=utf-8
{
"ret":0,
"msg":"",
"is_qq_vip ":1,
"qq_vip_level":3,
"is_qq_year_vip":1
}
{
"ret":0,
"msg":"",
"is_qq_vip ":1,
"qq_vip_level":3,
"is_qq_year_vip":1
}
XML示例:
<?xml version="1.0" encoding="UTF-8"?>
<data>
<ret>0</ret>
<msg></msg>
<is_qq_vip>1</nickname>
<qq_vip_level>5</qq_vip_level>
<is_qq_year_vip>1</is_qq_year_vip>
</data>
<data>
<ret>0</ret>
<msg></msg>
<is_qq_vip>1</nickname>
<qq_vip_level>5</qq_vip_level>
<is_qq_year_vip>1</is_qq_year_vip>
</data>
1.9 错误返回示例
Content-type: text/html; charset=utf-8
{
"ret":1002,
"msg":"请先登录"
}
{
"ret":1002,
"msg":"请先登录"
}