10/27/2025 18:02:31
账户互换接口
一、 查询第三方渠道账户id
1.1 接口名
/v2/profile/openid2uid
1.2 请求参数
| 参数 | 类型 | 描述 |
|---|---|---|
| openid | string | 【必填】 openid,即统一账户唯一标识(gopenid) |
| token | string | 【必填】 token,如果使用云游戏 token,请在 URL 中增加 cgsource 参数 |
| f_openid | string | 【选填】同渠道好友的 gopenid,如果存在这个字段,则返回这个字段对应的 uid,否则返回 openid 字段对应的 uid |
1.3 返回参数
| 参数 | 类型 | 描述 |
|---|---|---|
| ret | int | 返回码 0:正确,其它:失败 |
| msg | string | 返回结果详细说明 |
| uid | string | 第三方渠道账户 id |
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 请求参数
| 参数 | 类型 | 描述 |
|---|---|---|
| uid | string | 【必填】 第三方渠道账户 id |
| token | string | 【必填】 token |
2.3 返回参数
| 参数 | 类型 | 描述 |
|---|---|---|
| ret | int | 返回码 0:正确,其它:失败 |
| msg | string | 返回结果详细说明 |
| openid | string | openid,即统一账户唯一标识(gopenid) |
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", }
三、获取第三方渠道 token
3.1 接口名
/v2/profile/exchange_channel_token(仅限海外渠道使用)
3.2 请求参数
| 参数 | 类型 | 描述 |
|---|---|---|
| openid | string | 【必填】openid,即统一账户唯一标识(gopenid) |
| token | string | 【必填】token |
3.3 返回参数
| 参数 | 类型 | 描述 |
|---|---|---|
| ret | int | 返回码 0:正确,其他:失败 |
| msg | string | 返回结果详细说明 |
| channl_token | string | 第三方渠道的 token |
3.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" }
Copyright © 2025 MSDK.
All rights reserved.
All rights reserved.