11/25/2024 10:18:49
VIP 信息查询
一、 QQ 查询个人 VIP 信息
1.1 接口名
/v2/profile/query_qq_vip
1.2 请求参数
参数 | 类型 | 描述 |
---|---|---|
openid | string | 【必填】 用户唯一标识 |
token | string | 【必填】 用户的登录态 |
xinyue_upgrade | uint | 【选填】 该参数为1时,将查询新的心悦等级体系 |
vip | uint | 【必填】 查询类型 QQ 会员: vip & 0x01 != 0; QQ 等级: vip & 0x02 != 0; 蓝钻: vip & 0x04 != 0; 红钻: vip & 0x08 != 0; 超级会员: vip & 0x10 != 0; 心悦:vip & 0x40 != 0; 黄钻:vip & 0x80 != 0; 动漫:vip & 0x100 != 0; 心悦等级(新接口):vip&0x200 != 0; 以上类型可以任意组合(逻辑与),如需同时查询 QQ 会员和蓝钻则(vip & 0x01 != 0) && (vip & 0x04 != 0) 为真,(备注:请求时请只填相关的标识位) |
1.3 返回参数
参数 | 类型 | 描述 |
---|---|---|
ret | int | 返回码 0:正确,其它:失败 |
msg | string | 返回结果详细说明 |
lists | array | flag (int) VIP 类型标识; isvip (int) 判断用户 VIP 状态的标识, (0否, 1是); year (int) 是否年费, (0否, 1是); level (int) VIP 等级; luxury (int) 是否豪华版, (0否, 1是); |
1.4 请求示例
请求
curl -X POST -H 'Content-Type: application/json' 'https://hktest.itop.qq.com/v2/profile/query_qq_vip?channelid=2&gameid=12&os=1&seq=&source=0&ts=1552801460&version=2.0&sig=a7f076ed6c1dc7cde7275fc485799e15' -d '{"openid":"15879468368890148661","token":"935C4F643BC40AC88095429B1F063E07","vip":1}'
响应
{ "lists": [ { "flag": 1, "isvip": 0, "level": 0, "year": 0, "luxury": 0 } ], "ret": 0, "msg": "success" }
二、 QQ 查询个人 VIP 详细信息
2.1 接口名
/v2/profile/query_qq_vip_richinfo
2.2 请求参数
参数 | 类型 | 描述 |
---|---|---|
openid | string | 【必填】 用户唯一标识 |
token | string | 【必填】 用户的登录态 |
2.3 返回参数
参数 | 类型 | 描述 |
---|---|---|
ret | int | 返回码 0:正确,其它:失败 |
msg | string | 返回结果详细说明 |
is_lost | int | 判断是否有数据丢失.如果应用不使用 cache,不需要关心此参数。0 或者不返回:没有数据丢失,可以缓存。1:有部分数据丢失或错误,不要缓存。 |
is_qq_vip | int | 标识是否 QQ 会员(0:不是; 1:是) |
qq_vip_start | int | QQ 会员最后一次充值时间,标准时间戳 |
qq_vip_end | int | QQ 会员期限,标准时间戳 |
qq_year_vip_start | int | QQ 年费会员最后一次充值时间,标准时间戳 |
qq_year_vip_end | int | QQ 年费会员期限,标准时间戳 |
qq_svip_start | int | QQ SVIP 最后一次充值时间,标准时间戳 |
qq_svip_end | int | QQ SVIP 期限,标准时间戳 |
is_qq_year_vip | int | 标识是否 QQ 年费会员(0:不是; 1:是) |
is_svip | int | 标识是否 QQ 超级会员(0:不是; 1:是) |
2.4 请求示例
请求
curl -X POST -H 'Content-Type: application/json' 'https://hktest.itop.qq.com/v2/profile/query_qq_vip_richinfo?channelid=2&gameid=12&os=1&seq=&source=0&ts=1552801460&version=2.0&sig=969c70e8a56862736bd9018b4e60f00d' -d '{"openid":"15879468368890148661","token":"935C4F643BC40AC88095429B1F063E07"}'
响应
{ "is_lost": 0, "is_qq_vip": 0, "qq_vip_start": 0, "qq_vip_end": 0, "qq_svip_start": 0, "qq_svip_end": 0, "qq_year_vip_start": 0, "qq_year_vip_end": 0, "is_qq_year_vip": 0, "is_svip": 0, "ret": 0, "msg": "success" }
三、 QQ 查询好友 VIP 信息
3.1 接口名
/v2/profile/query_qq_friends_vip
3.2 请求参数
参数 | 类型 | 描述 |
---|---|---|
openid | string | 【必填】 用户唯一标识 |
token | string | 【必填】 用户的登录态 |
fopenids | array | 待查询的 QQ OpenID 列表(每次最多可输入49个) |
flags | string | VIP 业务查询标识。目前支持查询 QQ 会员信息: qq_vip, QQ 超级会员:qq_svip。如果需要查询多种 VIP 业务,通过“,”分隔。 |
userip | string | 请求 IP |
pf | string | 玩家登录平台,默认 openmobile,有 openmobile_android/openmobile_ios/openmobile_wp 等,该值来自客户端手 Q 登录返回 |
3.3 返回参数
参数 | 类型 | 描述 |
---|---|---|
ret | int | 返回码 0:正确,其它:失败 |
msg | string | 返回结果详细说明 |
is_lost | int | 判断是否有数据丢失.如果应用不使用 cache,不需要关心此参数。0 或者不返回:没有数据丢失,可以缓存。1:有部分数据丢失或错误,不要缓存。 |
lists | array | 包含 : openid(string)用户 ID is_qq_vip(int) 是否为 QQ 会员(0:不是; 1:是) qq_vip_level(int)QQ 会员等级(如果是 QQ 会员才返回) is_qq_year_vip(int)是否为年费 QQ 会员(0:不是; 1:是) is_qq_svip(int)是否为 QQ 超级会员(0:不是; 1:是) |
3.4 请求示例
请求
curl -X POST -H 'Content-Type: application/json' 'https://hktest.itop.qq.com/v2/profile/query_qq_friends_vip?channelid=2&gameid=12&os=1&seq=&source=0&ts=1552801460&version=2.0&sig=b10b0e284b86d311644c47099be30599' -d '{"openid":"15879468368890148661","fopenids":["B171547BCC30FCBC1A9B03744F1A8522"],"token":"935C4F643BC40AC88095429B1F063E07","userip":"192.168.0.1","flags":"qq_vip","pf":"openmobile"}'
响应
{ "lists": [ { "is_qq_svip": 0, "is_qq_vip": 0, "is_qq_year_vip": 0, "openid": "4724195171999796436", "qq_vip_level": 0 } ], "is_lost": 0, "ret": 0, "msg": "success" }
四、 查询微信心悦
4.1 接口名
/v2/profile/query_wx_xinyue_vip
4.2 请求参数
参数 | 类型 | 描述 |
---|---|---|
openid | string | 【必填】 用户唯一标识 |
token | string | 【必填】 用户的登录态 |
xinyue_upgrade | uint | 【选填】 该参数为1时,将查询新的心悦等级体系 |
serial | string | 流水号,建议为"业务简称_YYYYMMDD_HHMMSS_xxxxxx(6位随机数)" |
seven_flag | int | 值为 1 时,返回 7 段心悦 vip 会员信息: 1:游戏家 G1 2:游戏家 G2 3:游戏家 G3 4:游戏家 G4 5:心悦 vip1 6:心悦 vip2 7:心悦 vip3 其它值返回 3 段 vip 会员信息 1 - 心悦 vip1 2 - 心悦 vip2 3 - 心悦vip3 xinyue_upgrade = 1 时将忽略该字段,并且返回新版心悦 vip 会员信息: 1:游戏家 2:游戏家Pro 3:V1 4:V2 5:V3 6:V4 7:V5 |
4.3 返回参数
参数 | 类型 | 描述 |
---|---|---|
ret | int | 返回码 0:正确,其它:失败 |
msg | string | 返回结果详细说明 |
ilevel | int | 心悦等级,不是心悦用户返回 0;等级对应查看入参 seven_flag 说明 |
serial | string | 请求串透传 |
4.4 请求示例
请求
curl -X POST -H 'Content-Type: application/json' 'https://hktest.itop.qq.com/v2/profile/query_wx_xinyue_vip?channelid=1&gameid=12&os=1&seq=&source=0&ts=1552801460&version=2.0&sig=328e57c815b42074eac6698242a73cff' -d '{"openid":"3505996091832136773","token":"19_vgqLvxoe27KoVPavWDb6zFKHoMxcEra5x6LEx77GE-QqJafWnQZ05cUB8tZ_SJr6uK-d9g-pUk9yYoK24R1fa-JNTYnUpbCRctcnWnfHKTw","serial":"adsfasdfadsfsefewdsf","seven_flag":1}'
响应
{ "ilevel": 1, "serial": "adsfasdfadsfsefewdsf\n", "ret": 0, "msg": "success" }
请求
curl -X POST -H 'Content-Type: application/json' 'https://hktest.itop.qq.com/v2/profile/query_wx_xinyue_vip?channelid=1&gameid=12&os=1&seq=&source=0&ts=1552801460&version=2.0&sig=83ffc6476f3929381875ab5e790dd618' -d '{"openid":"3505996091832136773","token":"19_vgqLvxoe27KoVPavWDb6zFKHoMxcEra5x6LEx77GE-QqJafWnQZ05cUB8tZ_SJr6uK-d9g-pUk9yYoK24R1fa-JNTYnUpbCRctcnWnfHKTw","serial":"adsfasdfadsfsefewdsf","seven_flag":0}'
响应
{ "ilevel": 0, "serial": "adsfasdfadsfsefewdsf\n", "ret": 0, "msg": "success" }
五、QQ查询QQ手游贵族等级
说明:接口调用前,需要发邮件申请openkey,邮件模板请联系 MSDK 助手获取,并前往飞鹰管理端-我的游戏-游戏详情页-登录信息-手Q-查询手游贵族等级填写。
5.1 接口名
/v2/profile/query_qq_vip_level
5.2 请求参数
参数 | 类型 | 描述 |
---|---|---|
openid | string | 【必填】 用户唯一标识 |
token | string | 【必填】 用户的登录态 |
5.3 返回参数
参数 | 类型 | 描述 |
---|---|---|
ret | int | 返回码 0:正确,其它:失败 |
msg | string | 返回结果详细说明 |
level | int | 用户等级 |
score | int | 用户积分 |
5.4 请求示例
请求
curl -X POST -H 'Content-Type: application/json' 'https://hktest.itop.qq.com/v2/profile/query_qq_vip_level?channelid=2&conn=&gameid=12&os=1&seq=&source=0&ts=1571727463&version=2.0&sig=f6677d758da5fd9349739e58c135d9af' -d '{"token":"D46EF700A328F58231FF69045A54C91D","openid":"15879468368890148661"}'
响应
{ "level": 0, "score": 0, "ret": 0, "msg": "success", "seq": "1571728267-0268717065-026004-0000000806" }
Copyright © 2024 MSDK.
All rights reserved.
All rights reserved.