10/27/2025 18:02:26

Query VIP Information

I. Query Personal VIP Information via QQ

1.1 Interface name

/v2/profile/query_qq_vip

1.2 Request parameters

1.3 Return parameters

1.4 Request example

• Request

    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}'
  

• Response

    {    
        "lists": [    
            {    
                "flag": 1,    
                "isvip": 0,    
                "level": 0,    
                "year": 0,    
                "luxury": 0    
            }    
        ],    
        "ret": 0,    
        "msg": "success"    
    }
  

II. Query Personal VIP Details via QQ

2.1 Interface name

/v2/profile/query_qq_vip_richinfo

2.2 Request parameters

2.3 Return parameters

2.4 Request example

• Request

    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"}'
  

• Response

    {    
        "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"    
    }
  

III. Query Friends' VIP Information via QQ

3.1 Interface name

/v2/profile/query_qq_friends_vip

3.2 Request parameters

3.3 Return parameters

3.4 Request example

• Request

    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"}'
  

• Response

    {    
        "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"    
    }
  

IV. Query WeChat Xinyue

4.1 Interface name

/v2/profile/query_wx_xinyue_vip

4.2 Request parameters

4.3 Return parameters

4.4 Request example

• Request

    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}'
  

• Response

    {    
        "ilevel": 1,    
        "serial": "adsfasdfadsfsefewdsf\n",    
        "ret": 0,    
        "msg": "success"    
    }
  

• Request

    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}'
  

• Response

    {    
        "ilevel": 0,    
        "serial": "adsfasdfadsfsefewdsf\n",    
        "ret": 0,    
        "msg": "success"    
    }
  

V. QQ queries QQ mobile game's nobility level

Note: Before invoking the interface, the game needs to send an email to apply for an openkey. Please contact MSDK Assistant to obtain the email template, and then go to Feiying console-My game-Game details page-Login Information-QQ-Query mobile game's nobility level to fill in openkey.

5.1 Interface name

/v2/profile/query_qq_vip_level

5.2 Request parameters

5.3 Return parameters

5.4 Request example

• Request

    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"}'
  

• Response

    {
        "level": 0,
        "score": 0,
        "ret": 0,
        "msg": "success",
        "seq": "1571728267-0268717065-026004-0000000806"
    }