v3/user/total_vip_info

目录

What's New?

2013年10月30日,本接口新增返回参数“is_gamevip_yellow”,用于判断用户是否有超级套餐包月业务。

2013年4月25日,本接口切换到新功能,新功能如下:
1. 传一个参数,返回对应的一种VIP信息;
2. 不传参数,默认返回蓝钻和黄钻两种信息;
3. 支持查询VIP是否为豪华版的信息;
4. 支持查询3366会员等级信息;
5. 支持xml返回格式。

2013年4月3日起,本接口同时支持GET和POST请求方式。

2012年9月3日起,新接入的应用只能使用GET方式调用本接口。原有已经接入的应用如果使用POST方式发送请求不受影响,但是建议调整为使用GET方式。

1. 功能说明

获取登录用户的VIP信息,包括是否为QQ会员,蓝钻,黄钻,红钻,绿钻,粉钻,超级QQ,3366会员,是否为豪华版,是否年费(暂不能查询是否年费红钻),以及VIP等级。

注意:
(1)本接口返回的各种VIP信息是实时的,适用于需要VIP信息特别准确的场景(例如领取礼包场景中,非VIP用户开通VIP后,返回应用应该立即可领取礼包)。
(2)v3/user/get_info接口中也返回了用户的部分VIP信息,但是该接口返回的VIP信息是经过缓存的,有一定的延时。
(3)v3/user/is_vip接口中也返回了黄钻相关信息,与本接口返回的信息是一致的,即如果想获得实时黄钻信息,用2个接口都可以。

2. 接口调用说明

2.1 URL

http://[域名]/v3/user/total_vip_info

正式环境域名或测试环境IP详见:API3.0文档#请求URL说明

2.2 格式

json, xml

2.3 HTTP请求方式

GET, POST

2.4 IP限制

TRUE

2.5 输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738

(1)公共参数
发送请求时必须传入公共参数,详见公共参数说明

(2)私有参数
如果不传私有参数,或传入的私有参数的值都为“0”,只返回蓝钻和黄钻的相关信息。
如果需要获取其他的VIP信息,传入下面相应的参数,此时只返回传入参数对应的信息。
传入私有参数,一次只能获取一类VIP信息,如果一次传入多个VIP参数,只会返回一类VIP的相关信息。返回信息的优先级按以下参数排序返回,"member_vip"优先级最高,"is_3366"优先级最低。

参数名称 是否必须 类型 描述
member_vip string 是否查询QQ会员信息,1为查询,0或者不写为不查询。
blue_vip string 是否查询蓝钻信息,1为查询,0或者不写为不查询。
yellow_vip string 是否查询黄钻信息,1为查询,0或者不写为不查询。
red_vip string 是否查询红钻信息,1为查询,0或者不写为不查询。
green_vip string 是否查询绿钻信息,1为查询,0或者不写为不查询。
pink_vip string 是否查询粉钻信息,1为查询,0或者不写为不查询。
superqq string 是否查询超级qq信息,1为查询,0或者不写为不查询。
is_3366 string 是否查询3366信息,1为查询,0或者不写为不查询。

2.6 请求示例

http://openapi.tencentyun.com/v3/user/total_vip_info?
openid=B624064BA065E01CB73F835017FE96FA&
openkey=5F154D7D2751AEDC8527269006F290F70297B7E54667536C&
appid=2&
sig=9999b41ad0b688530bb1b21c5957391c&
pf=qzone&
format=json&
userip=112.90.139.30

2.7 返回参数说明

参数名称 描述
ret 返回码。详见公共返回码说明#OpenAPI V3.0 返回码
msg 如果错误,返回错误信息。
is_lost 判断是否有数据丢失。如果应用不使用cache,不需要关心此参数。

0或者不返回:没有数据丢失,可以缓存。
1:有部分数据丢失或错误,不要缓存。

 
is_vip 是否为QQ会员(0:不是; 1:是)
is_year_vip 是否是年费QQ会员(0:不是; 1:是)
vip_level QQ会员等级
is_high_vip 是否豪华版QQ会员(0:不是; 1:是)
 
is_blue 是否为蓝钻用户(0:不是; 1:是)
is_year_blue 是否是年费蓝钻用户(0:不是; 1:是)
blue_level 蓝钻等级
is_high_blue 是否豪华版蓝钻(0:不是; 1:是)
 
is_yellow 是否为黄钻用户(0:不是; 1:是)
is_year_yellow 是否是年费黄钻用户(0:不是; 1:是)
yellow_level 黄钻等级
is_high_yellow 是否豪华版黄钻(0:不是; 1:是)
is_gamevip_yellow 是否为超级套餐包月(0:不是; 1:是)
 
is_red 是否为红钻用户(0:不是; 1:是)
red_level 红钻等级
is_high_red 是否豪华版红钻(0:不是; 1:是)
 
is_green 是否为绿钻用户(0:不是; 1:是)
is_year_green 是否是年费绿钻用户(0:不是; 1:是)
green_level 绿钻等级
is_high_green 是否豪华绿钻(0:不是; 1:是)
 
is_pink 是否为粉钻用户(0:不是; 1:是)
is_year_pink 是否是年费粉钻用户(0:不是; 1:是)
pink_level 粉钻等级
is_pink_15 是否是15元粉钻用户(0:不是; 1:是)
is_year_pink_15 是否是年费15元粉钻用户(0:不是; 1:是)
 
is_superqq 是否为超级QQ用户(0:不是; 1:是)
superqq_level 超级QQ等级
 
level_3366 3366会员等级

2.9 正确返回示例

JSON示例:

Content-type: text/html; charset=utf-8
{
"ret":0,
"is_lost": 0,
"is_blue": 0,
"blue_level": 0,
"is_year_blue": 0,
"is_high_blue": 0,
"is_yellow": 1,
"yellow_level": 7,
"is_year_yellow": 1,
"is_high_yellow": 0,
}

2.10 错误返回示例

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

以上信息是否解决您的问题?

Copyright © 1998 - 2018 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部