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.

results matching ""

    No results matching ""