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

接口说明

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

先决条件

• 流程中存在Q币发货，且流程中由腾讯游戏来联运营人员配置了"检查QQ号"。
• 若不做检查直接提交到对应的流程ID，则流程会提示“请先绑定登记QQ信息”

{
  "iRet": -4008,
  "sMsg": "请先绑定登记QQ信息",
  "jData": null,
  "tid": "19ca89d6df6182ee858277190c689ca0",
  "v": 2,
  "apiName": "Error"
}

请求举例

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": {
    // uin不为空，用户已绑定QQ
    "uin": "1079***538",
    "accountAvatar": "http://thirdqq.qlogo.cn/ek_qqapp/AQL41Rytv2brGc3E6qaCpkR2m8orBSa4Z8Iqk15cJh6Jv3l7l0mOL0Ty2puqVIu0ARXof3XX0hdak/40",
    "accountName": "　　　　　　　　"
  },
  "tid": "f172372d87efce16cffacba4fd192e2d",
  "v": 2,
  "apiName": "GetRegUin"
}

返回说明

字段名称	字段类型	字段说明
uin	string	用户绑定的QQ号码，非空为存在绑定QQ
accountAvatar	string	用户QQ头像
accountName	string	用户QQ昵称

未绑定

{
  "iRet": 0,
  "sMsg": "ok",
  "jData": {
    // uin为空说明未绑定QQ

    "uin": "",
    "accountAvatar": "",
    "accountName": ""
  },
  "tid": "c99859f6ec748f9c34d0ea8ad4c58526",
  "v": 2,
  "apiName": "GetRegUin"
}