分享到 :

get_vip_info

特别声明

出于信息安全的考虑,本接口仅对可信赖的合作网站开放。

已经成功接入“QQ登录”的网站需提交申请以获取访问OpenAPI的权限。

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

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

}

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>

1.9 错误返回示例

Content-type: text/html; charset=utf-8
{
"ret":1002,
"msg":"请先登录"
}

 

返回顶部