12/12/2024 11:37:56

账户互换接口

一、 查询第三方渠道账户id

1.1 接口名

/v2/profile/openid2uid

1.2 请求参数

1.3 返回参数

1.4 请求示例

• 请求

    curl -X POST 'https://hktest.itop.qq.com/v2/profile/openid2uid?channelid=1&gameid=12&os=2&source=0&ts=1543583577&sig=71fbf808db338a4733c194cfd0fbc0bc' -d '{"token":"16__7PhV9W6PeKtH0yW4Bs6fMwn8wYJgtwluX6_sLwxN8dfCSYajqtWUW3JPaOp170nSZNOvpr2zHHRmiERbPwmQqwrtB6nKwk0v-GhJ9JwXcg","openid":"10259875237126117000"}'
  

• 响应

    {
        "ret": 0,
        "msg": "success",
        "openid": "10259875237126117000",
        "uid": "oHlap1Rcz0d6svU4cwah-c0L3OzQ",
        "seq":"1578039139-0268717065-004704-0000087756"
    }
  

• 请求

    curl -X POST -H 'Content-Type: application/json' 'https://hktest.itop.qq.com/v2/profile/openid2uid?channelid=2&conn=&gameid=12&os=1&seq=&source=0&ts=1578039002&version=2.0&sig=0e1721c469920ed08a4e9c37678537b8' -d '{"openid":"15879468368890148661","token":"D46EF700A328F58231FF69045A54C91D","f_openid":"7596233514244205937"}'
  

• 响应

    {
        "ret": 0,
        "msg": "success",
        "openid": "7596233514244205937",
        "uid": "255E40A981DF206E75975A7440098C1D",
        "seq": "1578039046-0268717065-004704-0000087754"
    }
  

二、 查询统一账户id

2.1 接口名

/v2/profile/uid2openid

2.2 请求参数

2.3 返回参数

2.4 请求示例

• 请求

    curl -X POST 'https://hktest.itop.qq.com/v2/profile/uid2openid?channelid=1&gameid=12&os=2&source=0&ts=1543584407&sig=6077c1a5de15a3c5e9bcdbedec2928f8' -d '{"token":"6srOlTx3YVgpNCjf5wndaT8em6PUA0QEs77OwXbIgBLoTEhbJxgoDevhrp2uxcH8","uid":"oHlap1Rcz0d6svU4cwah-c0L3OzQ"}'
  

• 响应

    {
        "ret": 0,
        "msg": "success",
        "openid": "10259875237126117000",
    }
  

三、查询第三方渠道账户 ID（不带 token，限制 source）

3.1 接口名

/v2/profile/openid2uid_notoken

3.2 使用说明

不带 token：此接口仅供内部无 token 的组件使用；

限制 source：游戏业务无需申请 source，请求时 source = 1。
      其他组件新接入需要申请 source 才能使用此接口；source 申请请联系 MSDK助手。

3.3 请求参数

3.4 返回参数

3.5 请求示例

• 请求

    curl -X POST -H 'Content-Type: application/json' 'https://hktest.itop.qq.com/v2/profile/openid2uid_notoken?channelid=9&gameid=11&os=1&seq=&source=0&ts=1558666012&version=2.0&sig=5f9d773fa560bf76ca07c9fd82f76e43' -d '{"openid":"6654814801566087952"}'
  

• 响应

    {
        "ret":0,
        "msg":"success",
        "uid":"1112070588"
    }
  

四、查询统一账号 ID（不带 token，限制 source）

4.1 接口名

/v2/profile/uid2openid_notoken

4.2 使用说明

不带 token：此接口仅供内部无 token 的组件使用；

限制 source：每个组件对应一个 source，新接入需要申请 source 才能使用此接口；source 申请请联系 MSDK助手；

4.3 请求参数

4.4 返回参数

4.5 请求示例

• 请求

    curl -X POST -H 'Content-Type: application/json' 'https://hktest.itop.qq.com/v2/profile/uid2openid_notoken?channelid=9&gameid=11&os=1&seq=&source=0&ts=1558666012&version=2.0&sig=06c4fd21e8f27d3da2f89ee0bcf77e49' -d '{"uid":"1112070588"}'
  

• 响应

    {
        "ret":0,
        "msg":"success",
        "openid":"6654814801566087952"
    }
  

五、获取第三方渠道 token

5.1 接口名

/v2/profile/exchange_channel_token（仅限海外渠道使用）

5.2 请求参数

5.3 返回参数

5.4 请求示例

• 请求

    curl -X POST -H 'Content-Type: application/json' 'https://hktest.itop.qq.com/v2/profile/exchange_channel_token?channelid=9&gameid=11&os=1&seq=&source=0&ts=1558666012&version=2.0&sig=e6b72b5ad42aaed268eae5a31b950630' -d '{"openid":"6654814801566087952","token":"91c538ff9ea265af2814f35e4e72d5032178d46f"}'
  

• 响应

    {
        "ret":0,
        "msg":"success",
        "channel_token":"1112070588-zlaMZWcXi1qClE4P0Kphux3Q90PapSy0u6PworD"
    }
  

六、获取 AppID

6.1 接口名

/v2/comm/get_appid

6.2 请求参数

填入一个空的 json 对象即可

6.3 返回参数

6.4 请求示例

• 请求

    curl -X POST -H 'Content-Type: application/json' 'https://dev.itop.qq.com/v2/comm/get_appid?channelid=2&gameid=11&os=1&seq=&source=0&ts=1559121639&version=2.0&sig=69de2d7c4225136095f5f15418d60087' -d '{}'
  

• 响应

    {
        "ret":0,
        "msg":"success",
        "appid":"1106977030"
    }