# 移动端QQ绑定、Q币发放接入

# 适用场景

用于跳转到手Q内进行绑定

# 跳转模式

平台客户端打开链接mqqapi://forward/url?src_type=web&version=1&url_prefix=base64(xxx)跳转到手Q内livelink绑定页

其中xxx表示生成跳转的livelink页面带参数的最终地址,url_prefix参数填入livelink页面地址的base64版本

# 基础页面地址

qq绑定页基础地址 生产环境: https://livelink.qq.com/binder/mobile/ (opens new window)
测试环境: https://test.livelink.qq.com/binder/mobile/ (opens new window)

Q币发货页面基础地址 生产环境: https://livelink.qq.com/binder/mobile/qq-coin-delivery/ (opens new window)
测试环境: https://test.livelink.qq.com/binder/mobile/qq-coin-delivery/ (opens new window)

使用活动测试工具快速测试

# queryString 参数说明

字段 字段说明 是否需要加入签名(sig) 是否必填
gameIdList 游戏 id 列表, 参考已接入业务 示例:cf, lol, yxzj
code 包含 uid 的加密串, 参考 平台侧构建code
livePlatId 平台 id
t 时间戳
sig 签名,参考《小程序绑定:生成拉起签名》
actId 指活动 ID,在平台综合绑定中心入口不需要传该参数。但活动场景下为必传
faceUrl 用户所在平台头像
nickName 用户所在平台昵称
redirectUrl 完成绑定后的跳转链接,如需跳转到原平台,需传入deeplink地址
gameAuthScene 授权场景(对应不同的授权字段,活动场景为act_${actId},其他场景可咨询对接人员)
needLoginState 是否需要进行后续登录态校验; 不传默认为false, 传入true表示后续需要校验
nextFlow 发放真实Q币的流程id。若需引导用户到小程序内完成QB兑换,则此参数为必传参数,nextFlow参数中的值来自上一步发货接口的返回
fromId 来源Id, 后续会在后台回调中带上该信息,长度限制为32,超过则丢弃

*注意1:不应传入多余的参数,最终生成的路径与参数的总长度不可超过1024,超过会被小程序底层逻辑截断 *注意2:所有参数均需 encode(编码)一次,编码规范参见encodeURIComponent (opens new window)。go语言中应使用url.PathEscape方法**,其他语言类似。注意生成的参数其中不包含;,/?:@&=+$#等参数,可以使用对应语言方法调用试下

# 调用示例

https://livelink.qq.com/binder/mobile/?t=1591236939&gameIdList=lol%2C%20cjm&livePlatId=douyu&sig=6e766f5017a737b82d99ae09b7b922da&faceUrl=http%3A%2F%2Fthirdqq.qlogo.cn%2Fg%3Fb%3Doidb%26k%3DgeNGjUqkHHLJdibhAaKycMQ%26s%3D100%26t%3D1483405761&nickName=%E6%96%97%E9%B1%BC%E6%98%B5%E7%A7%B0&redirectUrl=https%3A%2F%2Fwww.douyu.com&code=25QY9rzaUK9vO0QYUHbNnNTkp0B4tRrmp%2BLog1LhBSYe6psYyShjUnUwzOa7t%2FwoP8RpzTYZICVTXwvNHgh7cg%3D%3D
1

# 正式环境测试工具

绑定测试工具地址: https://livelink.qq.com/activities/#/testTool?activeName=bindCenter (opens new window)

隐私授权工具地址: https://livelink.qq.com/activities/#/testTool?activeName=gameDataAuth (opens new window)

lastUpdate: 11/12/2024, 3:43:23 PM