# 移动端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
# 正式环境测试工具
绑定测试工具地址: https://livelink.qq.com/activities/#/testTool?activeName=bindCenter (opens new window)
隐私授权工具地址: https://livelink.qq.com/activities/#/testTool?activeName=gameDataAuth (opens new window)