用户绑定查询

接口说明

判定平台用户是否有绑定腾讯游戏角色信息。可用于活动判定。

先决条件

• 平台已完成腾讯游戏来联接入流程。
• 系统接口无需立项亦可使用。

请求举例

curl "https://s1.livelink.qq.com/livelink/?apiName=GetBindInfo&actId=691&code=Sw4iQUPDf6MsRE8AG8Vyd6xpP5kV70luCih4rdPwKiE%3D&gameId=yl&livePlatId=egame&nonce=10962347&sig=797c7f8a4dee1352de3c25cb3b5d8e5a&t=1610962347&v=2.0"

参数说明

字段名称	字段类型	字段是否必填	字段说明
actId	int	是	活动 ID
apiName	string	是	固定为"GetBindInfo"
code	string	是	用户登录态
gameId	string	是	游戏 ID
livePlatId	string	是	平台
nonce	string	是	8 位随机字符串
sig	string	是	签名，同请求apiRequest生成sig一样
t	int	是	时间戳
v	string	是	版本号，当前最新版本为2.0

输出举例

1. 有绑定的情况

{
  "iRet": 0,
  "v": 2,
  "apiName": "GetBindInfo",
  "jData": {
    "isBind": true,
    "bindTime": 1711434444,
    "gameAcc": {
      "type": "qq"
    },
    "gameRole": {
      "roleName": "史蒂夫哀伤",
      "areaName": "手Q",
      "partitionName": "",
      "platName": "苹果(iOS)",
      "id": "xxxx",
      "icon": "http://xxxx"
    }
  },
  "sMsg": "ok",
  "tid": "190819135603610672"
}

2. 没有绑定的情况

{
  "iRet": 0,
  "jData": {
    "isBind": false,
    "bindTime": 0,
    "gameAcc": {
      "type": ""
    },
    "gameRole": {
      "roleName": "",
      "areaName": "",
      "partitionName": "",
      "platName": "",
      "id": "",
      "icon": ""
    }
  },
  "sMsg": "ok",
  "tid": "190819629659067440"
}

返回说明

参数	类型	说明
isBind	bool	是否绑定角色
gameAcc.type	string	绑定账号类型。值为：wx/qq
gameRole.roleName	string	角色名称
gameRole.areaName	string	游戏大区
gameRole.partitionName	string	游戏小区
gameRole.platName	string	系统
gameRole.id	string	角色id
bindTime	int	绑定时间戳
platUser.nickName	string	平台用户昵称

注意: 游戏大区，游戏小区，系统取决于游戏本身大区架构。如果游戏不支持，则此处返回填充为空字符串。