查询用户是否完成QQ号码填写

接口说明

该接口用于预先判断平台登录用户是否已经填写过QQ号码。如果在相关活动中没有事先使用该接口进行预判，当调用相关流程时，系统会提示“未查询到QQ信息，请先绑定并登记QQ信息”。这个提示可以作为一个保底提示信息，引导用户完成QQ号码的填写。如需填写或更新QQ号码，见平台填写QQ号码。

先决条件

• 流程中存在Q币发货，且流程中由腾讯游戏来联运营人员配置了"检查QQ号"。

请求举例

curl https://s1.livelink.qq.com/livelink/?actId=2345&apiName=GetRegUin&code=P7GNybGDwoVnRhhhhhhhhhM3VqA564gKbSg%3D&gameId=wslg&livePlatId=egame&nonce=60635492&sig=c9b330e168382bf2a74486821965dbe4&t=1660635492&v=2.0

参数说明

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

输出举例

已绑定

{
  "iRet": 0,
  "sMsg": "ok",
  "jData": {
    "isBind": true,
    "gameAcc": {
      "type": "qq"
    },
    "gameRole": {
      "roleName": "Tvi8",
      "areaName": "手Q",
      "platName": "安卓(android)",
      "partitionName": "",
      "id": "87a7f7cbf8a97c63bbfc21bdce6975a9ee6db3cb",
      "gameIcon": "https://livelink.qq.com/img-cdn/act/cjm.png"
    },
    "bindTime": 1712922055
  },
  "tid": "0565d4aacb49a47d6b2deed3a1e19aff",
  "v": 2,
  "apiName": "GetBindInfo"
}

返回说明

字段名称	字段类型	字段说明
isBind	bool	该平台账号是否绑已绑定游戏角色
gameAcc.type	string	绑定账号类型，wx/qq
gameRole	object	游戏角色信息
gameRole.roleName	string	游戏角色名称
gameRole.areaName	string	游戏角色所在地区
gameRole.platName	string	游戏角色所在平台
gameRole.partitionName	string	游戏角色分区
gameRole.id	string	游戏角色 ID
gameRole.gameIcon	string	游戏图标
bindTime	int	绑定时间戳，单位秒

未绑定

{
  "iRet": 0,
  "sMsg": "ok",
  "jData": {
    "isBind": false,
    "gameAcc": {
      "type": ""
    },
    "gameRole": {
      "roleName": "",
      "areaName": "",
      "platName": "",
      "partitionName": "",
      "id": "",
      "gameIcon": ""
    },
    "bindTime": 0
  },
  "tid": "ce7508e23d357dd10f52633f5c35e9cb",
  "v": 2,
  "apiName": "GetBindInfo"
}