# 活动详情获取
# 接口说明
读取腾讯游戏来联侧活动配置信息。
# 先决条件
- 平台已完成腾讯游戏来联接入流程。
- 系统接口无需立项亦可使用。
# 注意事项
- 该接口为系统接口。不能用于处理玩家请求。
# 请求举例
curl "https://s1.livelink.qq.com/livelink/?apiName=ApiDoc&livePlatId=xxx&actId=0&gameId=cfm&v=2.0&t=1590743898&nonce=32c6dc63&code=4%2FqMz8bSuoE%2F1WjIq0fhUgvM6%2BTfomvadEyYYF0aSG6NlvpfjSSF6NVXxkpKIAakzuaXlONUJnWKVEwIUOtwiw%3D%3D&sig=d433bdaf29cb65badf4b856a7bb0ec38"
1
# 参数说明
| 参数名称 | 参数类型 | 说明 | 必填 | 加入签名 |
|---|---|---|---|---|
| apiName | string | 值为: ApiDoc | 是 | 否 |
| livePlatId | string | 直播平台ID，由直播平台统一分配 | 是 | 是 |
| actId | int | 活动ID，可在腾讯游戏来联上分配 | 是 | 是 |
| gameId | string | 业务名称，见《业务代码》 | 是 | 是 |
| v | float | 版本号，当前最新版本为2.0 | 是 | 是 |
| t | int | Unix时间戳，精度：秒 | 是 | 是 |
| nonce | string | 随8位机字符串，字符串范围：0-9z-A | 是 | 是 |
| sig | string | 签名，见《生成签名》 | 是 | 否 |
# 输出举例
{
"iRet": 0, // 接口调用ok，非0失败
"sMsg": "ok", // 如果遇到非0返回，此处为错误信息
"v":2,
"apiName":"ApiDoc",
"jData": {
"id": "332", // 活动id
"actStatus": 0, // 活动状态，0配置中，1测试中，2已发布
"livePlatId": "livelink", // 平台id
"name": "live测试活动", // 活动名称
"gameId": "cfm", // 游戏业务码
"bindType": 0, // 绑定类型，1不允许换绑，0可换绑
"changBindDay": 0,// 0表示不可循环换绑，大于0表示 循环周期
"startActualTime": "2024-07-29 00:00:00", // 活动真实上线时间
"endActualTime": "2024-07-30 23:59:59", // 活动真实结束时间
"actDate": [
"2020-05-22 20:53:49",
"2020-05-25 20:53:59"
], // 活动时间
"privacyAuthScene": "act_332", // 隐私授权场景值，如果返回空表示活动不需要用户隐私授权
// 礼包单号信息部分
"pkgInfo": [
// 道具列表，一个actid下可能会有多个礼包物，故此处使用列表
{
"list": "IEGAMS-295687-339648", // 礼包单号
"status": "2", // 2 标识已发布，其他表示发布错误
"begin": "2020-04-01 00:00:00", // 礼包开始有效期
"end": "2020-04-30 23:59:59", // 礼包截止有效期
"group": [
// 礼包组
{
// 礼包组1
"gd": "1188971", // 礼包组id
"t": "0", // 类型：0为领取，1抽奖
"gn": "小喇叭1号", // 礼包组名称
"de": "0", // 默认礼包id，领取类为0
"gi": [
{
"pn": "小喇叭1号", // 礼包名称，用户领取成功会提示该名称，请不要使用默认new group等模糊的礼包名称
"pd": "1827859", // 礼包id
"rd": "0", // 礼包概率，领取类礼包概率为0
"l": "0|0|0|0|100", // 礼包限量(时|日|周|月|总)
"ul": "0|0|0|0|10", // 单用户限量(时|日|周|月|总)
"ut": "uin", // 礼包单用户限量类型：单用户还是用户+大区还是用户+大区+角色
"i": [
// 使用者放发货不用关心该字段，仅仅用于到账验证。礼包所包含内容物，即到账之后用户可获得的具体道具，可能会有多个。
{
"tn": "小喇叭", // 道具名称
"tc": "1" // 道具数量
}
],
"pval": 1 // 礼包组价值
}
]
},
{
// 礼包组2，字段说明参考 “礼包组1”
"gd": "1208722",
"t": "0",
"gn": "小喇叭1",
"de": "0",
"gi": [
{
"pn": "小喇叭1",
"pd": "1858625",
"rd": "0",
"l": "0|0|0|0|1",
"ul": "0|0|0|0|1",
"ut": "uin",
"i": [
{
"tn": "小喇叭",
"tc": "1"
}
],
"pval": 1
}
]
}
]
}
],
// 流程信息部分
"flows": [
{
// 流程1 配置信息
"info": {
"reentrant": 1, // 可重入标识，1可重入
"id": "o4j0ippq", // 流程id
"name": "累计登录游戏7天", // 流程名称
"tag": 1, // 流程属性：判定+发货 对应值：1;纯判定用于输出（true false） 对应值：2;纯发货 对应值：3
"desc": "用户累计登录游戏7天判定，用于领取登陆7天好礼礼包，每个用户领取1次", // 流程使用描述
"startTime": "", // 流程开始时间，空值默认跟随活动时间
"endTime": "", // 流程结束时间，空值默认跟随活动时间
"limit": {
// 资格限制情况
"sOpenId": true, // 限制玩家游戏账号
"sUserId": true, // 限制玩家平台账号
"interval": "once", // once 活动期间， day 自然天， week 自然周, month 自然月
"chance": 1 // 资格次数
},
// 流程限频：每 limitSec 秒 限频 limitCount 次，0走系统默认限制
"limitSec": 0,
"limitCount": 0
},
// 自定义参数部分，自定义参数备注部分正在改造中，暂时不提供参数备注功能
"request": [
{
"param": "taskId",
"note": "",
"type": ""
}
],
"pkg": {
"groupId": "1687328", // 该流程用到的礼包组id
"packageId": "IEGAMS-392957-418611" // 该流程用到的礼包单
},
// 标准化输出
"standardOutput": [
{
"key_alias": "data", // 字段别名
"api_alias": "djc_item_all",
"type": 1, // 输出类型，0常量；1原值；2比较
"conf_value": "", // 被比较的值
"cmp": "" // 比较类型，如：>=、!=
}
]
}
]
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131