返回顶部

get_vip_rich_info

特别声明

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

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

1 接口说明

获取已登录用户的关于QQ会员业务的详细资料。

详细资料包括:用户会员的历史属性,用户会员特权的到期时间,用户最后一次充值会员业务的支付渠道,用户开通会员的主要驱动因素。

1.1 URL

OAuth2.0协议: https://graph.qq.com/user/get_vip_rich_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_rich_info?

access_token=*************&

oauth_consumer_key=12345&

openid=****************&

format=json

1.6 返回参数说明

参数名称 描述
ret 返回码
msg 如果ret<0,会有相应的错误信息提示,返回数据全部用UTF-8编码
is_qq_vip 标识是否QQ会员(0:不是; 1:是)
qq_vip_start QQ会员最后一次充值时间
qq_vip_end QQ会员期限
qq_vip_payway QQ会员充值方式
qq_year_vip_start QQ年费会员最后一次充值时间
qq_year_vip_end QQ年费会员期限
qq_year_vip_payway QQ年费会员充值方式
qq_zuanhuang_start QQ钻皇最后一次充值时间
qq_zuanhuang_end QQ钻皇期限
qq_zuanhuang_payway QQ钻皇充值方式
qq_haohua_start 豪华版QQ会员最后一次充值时间
qq_haohua_end 豪华版QQ会员期限
qq_haohua_payway 豪华版QQ会员充值方式
qq_svip_start QQ SVIP最后一次充值时间,预留字段,当前信息无效
qq_svip_end QQ SVIP期限,预留字段,当前信息无效
qq_svip_payway QQ SVIP充值方式,预留字段,当前信息无效
history_pay_time 非会员历史充值时间,仅在用户是非会员时信息有效
history_end_time 非会员历史充值到期时间,仅在用户是非会员时信息有效

 

qq_vip_paywayqq_year_vip_paywayqq_zuanhuang_paywayqq_haohua_payway字段返回数据说明

payway返回值 说明
5 网银/财付通
100 QQ卡
101 声讯
102 ESALES
103 他人赠送
104 索要
105 公司活动赠送
106 免费
107 电信卡
108 手机充值卡
109 广州收费易
110 索要
111 Q点
112 EPAY
113 MPAY
114 声讯预付费
115 拍拍渠道
116 申诉返还
117 手机ivr
118 Q币Q点
119 Q点Q币
(其他数字) 其他渠道

1.7 返回码说明

0: 正确返回

其它: 失败。错误码说明详见:公共返回码说明

1.8 正确返回示例

JSON示例:

Content-type: text/html; charset=utf-8

{

“ret”:0,

“msg”:””,

“is_lost”: 0,

“is_qq_vip”: 1,

“is_qq_year_vip”: 0,

“qq_vip_level”: 5,

“qq_vip_start”: 1313974842,

“qq_vip_end”: 1359507642,

“qq_vip_payway”: 111,

“qq_year_vip_start”: 1326771509,

“qq_year_vip_end”: 1358912309,

“qq_year_vip_payway”: 0,

“qq_zuanhuang_start”: 0,

“qq_zuanhuang_end”: 0,

“qq_zuanhuang_payway”: 0,

“qq_haohua_start”: 0,

“qq_haohua_end”: 0,

“qq_haohua_payway”: 0,

“qq_svip_start”: 0,

“qq_svip_end”: 0,

“qq_svip_payway”: 0,

“history_pay_time”: 0,

“history_end_time”: 0

}

XML示例:

<?xml version=”1.0″ encoding=”UTF-8″?>

<data>

<ret>0</ret>

<msg></msg>

<is_lost>0</is_lost>

<is_qq_vip>1</is_qq_vip>

<is_qq_year_vip>0</is_qq_year_vip>

<qq_vip_level>5</qq_vip_level>

<qq_vip_start>1313974842</qq_vip_start>

<qq_vip_end>1359507642</qq_vip_end>

<qq_vip_payway>111</qq_vip_payway>

<qq_year_vip_start>1326771509</qq_year_vip_start>

<qq_year_vip_end>1358912309</qq_year_vip_end>

<qq_year_vip_payway>0</qq_year_vip_payway>

<qq_zuanhuang_start>0</qq_zuanhuang_start>

<qq_zuanhuang_end>0</qq_zuanhuang_end>

<qq_zuanhuang_payway>0</qq_zuanhuang_payway>

<qq_haohua_start>0</qq_haohua_start>

<qq_haohua_end>0</qq_haohua_end>

<qq_haohua_payway>0</qq_haohua_payway>

<qq_svip_start>0</qq_svip_start>

<qq_svip_end>0</qq_svip_end>

<qq_svip_payway>0</qq_svip_payway>

<history_pay_time>0</history_pay_time>

<history_end_time>0</history_end_time>

</data>

1.9 错误返回示例

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