12/25/2024 11:11:54

查询绑定关系【海外】

一、查询账号绑定关系

1.1 接口名

/v2/profile/get_bind_info

1.2 请求参数

参数 类型 描述
openid string 【必填】
token string 【必填】

1.3 返回参数

参数 类型 描述
ret int 返回码0：正确，其他：失败
msg string 返回结果详细说明
bind_list array 返回结果详细说明

其中 bind_list 的数组中为绑定的描述对象，包含以下字段

参数 类型 描述
channelid int 渠道号
user_name string 用户名或昵称
picture_url string 头像URL地址
channel_info object 渠道自定义字段，其中包含的字段随渠道变化，如果没有自定义信息则为空的对象
timestamp int 与该账号绑定的Unix时间戳

1.4 请求示例

  • 请求
    curl -X POST -H 'Content-Type: application/json' 'https://hktest.itop.qq.com/v2/profile/get_bind_info?channelid=4&gameid=11&os=1&seq=&source=0&ts=1583488081&version=2.0&sig=d0dabe16fb5241bbcd84517aa4e2f670' -d '{"openid":"17059603775778004866","token":"d1b16777eeaf0fd06ab20600a433821cc656c81b"}'
  • 响应
    {
"seq": "1583488081-0268717065-028958-0000000026",
"bind_list": [
  {
    "channel_info": {
      "phone": "15002097136",
      "phonearea": "86",
      "email": ""
    },
    "picture_url": "",
    "user_name": "86-15002097136",
    "channelid": 11
  },
  {
    "channel_info": {},
    "picture_url": "https://graph.facebook.com/v3.0/1071441666368496/picture?width=160&height=160",
    "user_name": "",
    "channelid": 4
  },
  {
    "channel_info": {
      "phone": "15002097136",
      "phonearea": "86",
      "email": ""
    },
    "picture_url": "",
    "user_name": "86-15002097136",
    "channelid": 7
  }
],
"msg": "success",
"ret": 0
}

二、解绑账号

[info] 注意：

1、请务必核对用户身份后调用本接口

2、该接口仅用于断开绑定关系场景，切勿用于账号删除，账号删除请使用专用的账号删除接口

3、建议设置多次弹框确认或经过一定反悔期后再调用该接口执行

2.1 接口名

/v2/auth/unbind

2.2 请求参数

参数 类型 描述
openid string 【必填】 统一账户唯一标识
token string 【必填】 token
unbind_channelid int 【必填】待解绑的渠道标识
uid string 【可选】待解绑的渠道用户标识，如果不传，后台根据 gameid + unbind_channelid + openid 查询带解绑渠道的 uid，进行解绑。当支持单渠道绑定多个账号时，必须传递该参数

2.3 返回参数

参数 类型 描述
ret int 返回码 0：正确，其它：失败
msg string 返回结果详细说明

2.4 请求示例

  • 请求
    curl -sS -X POST -H 'Content-Type: application/json' 'https://hktest.itop.qq.com/v2/auth/unbind?channelid=4&conn=&gameid=11&os=1&seq=&source=0&ts=1585629374&version=2.0&sig=59f107afc80b74ae4a38cef7ac2ee5e9' -d '{"openid":"11633715105364962129","token":"f62074edbf2fb285e082c2c9b9b8689339863003","unbind_channelid":4,"uid":"1071441666368496"}' | jq '.'
  • 响应
    {
"seq": "1586243851-0268717065-038830-0002703813",
"msg": "success",
"ret": 0
}

三、删除账号

[info] 注意：

1、请务必核对用户身份后调用本接口

2、账号删除后无法恢复

3、建议设置多次弹框确认或经过一定反悔期后再调用该接口执行

4、该接口用于为满足内部策略优化要求而产生的账号注销类需求，调用后将清除该 gopenid 在 MSDK 账号存储中所有相关数据

5、每个渠道账号（指facebook、qq、微信等渠道账号，非gopenid）最多允许被删除10次，超出后该渠道账号无法再注册新账号。

3.1 接口名

/v2/auth/unregister

3.2 请求参数

参数 类型 描述
openid string 【必填】 统一账户唯一标识

3.3 返回参数

参数 类型 描述
ret int 返回码 0：正确，其它：失败
msg string 返回结果详细说明

3.4 请求示例

  • 请求
    curl -sS -X POST -H 'Content-Type: application/json' 'https://hktest.itop.qq.com/v2/auth/unregister?channelid=4&conn=&gameid=11&os=1&seq=&source=0&ts=1585629374&version=2.0&sig=59f107afc80b74ae4a38cef7ac2ee5e9' -d '{"openid":"11633715105364962129"}' | jq '.'
  • 响应
    {
"seq": "1586243851-0268717065-038830-0002703813",
"msg": "success",
"ret": 0
}



Copyright © 2024 MSDK.
All rights reserved.

results matching ""

    No results matching ""