# 活动禁止换绑说明
# 说明
该部分接口只能用于禁止换绑的活动,普通活动的绑定信息查询接口参见
# 接口 1: 绑定用户与活动关系
说明: 将用户账号信息与活动进行绑定,此后该用户参与该活动的绑定信息就固定下来,不可进行更换。
接口地址:https://s1.livelink.qq.com/livelink/ (opens new window)
# 调用示例
https://s1.livelink.qq.com/livelink/?apiName=ActBind&actId=691&code=Sw4iQUPDf6MsRE8AG8Vyd6xpP5kV70luCih4rdPwKiE%3D&gameId=yl&livePlatId=huya&nonce=10962347&sig=797c7f8a4dee1352de3c25cb3b5d8e5a&t=1610962347&v=2.0
1
# 接口入参
字段名称 | 字段类型 | 字段是否必填 | 字段说明 |
---|---|---|---|
actId | int | 是 | 活动 ID |
apiName | string | 是 | 固定为"ActBind" |
code | string | 是 | 用户登录态 |
gameId | string | 是 | 游戏 ID |
livePlatId | string | 是 | 平台 |
nonce | string | 是 | 8 位随机字符串 |
sig | string | 是 | 签名,同请求apiRequest 生成sig 一样 |
t | int | 是 | 时间戳 |
v | float | 是 | 版本号,填写1.1。如立项中使用了2.0版本活动,则此处需要修改为2.0 |
# 接口返回
{
"iRet": 0,
"sMsg": "ok",
"tid": "184150964565972015"
}
1
2
3
4
5
2
3
4
5
# 接口 2: 查询用户在活动中的绑定信息
说明:查询该用户在当前活动中的账号和角色的绑定信息。
接口地址:https://s1.livelink.qq.com/livelink/ (opens new window)
# 调用示例
https://s1.livelink.qq.com/livelink/?apiName=GetActBind&actId=691&code=Sw4iQUPDf6MsRE8AG8Vyd6xpP5kV70luCih4rdPwKiE%3D&gameId=yl&livePlatId=huya&nonce=10962347&sig=797c7f8a4dee1352de3c25cb3b5d8e5a&t=1610962347&v=2.0
1
# 接口入参
字段名称 | 字段类型 | 字段是否必填 | 字段说明 |
---|---|---|---|
actId | int | 是 | 活动 ID |
apiName | string | 是 | 固定为"GetActBind" |
code | string | 是 | 用户登录态 |
gameId | string | 是 | 游戏 ID |
livePlatId | string | 是 | 平台 |
nonce | string | 是 | 8 位随机字符串 |
sig | string | 是 | 签名,同请求apiRequest 生成sig 一样 |
t | int | 是 | 时间戳 |
v | string | 是 | 版本号 |
# 接口返回
- 已绑定的情况
{
"apiName": "GetActBind",
"iRet": 0,
"jData": {
"changBindTime":"2022-06-30 00:00:00" ,// 下次可换绑的时间 空为不可换绑
"gameAcc": {
"type": "qq",
"faceuri": "http://thirdqq.qlogo.cn/g?b=0&t=1483443838",
"nick": "kiowen"
},
"gameRole": {
"roleName": "史蒂夫哀伤",
"areaName": "手Q",
"partitionName": "",
"platName": "苹果(iOS)"
}
},
"sMsg": "ok",
"tid": "184150964565972015"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
- 未绑定的情况
{
"apiName": "GetActBind",
"iRet": -4005,
"sMsg": "用户还未进行活动确认",
"tid": "184150964565972015"
}
1
2
3
4
5
6
2
3
4
5
6