活动列表获取

接口说明

读取调用方在腾讯游戏来联侧活动列表。

先决条件

• 平台已完成腾讯游戏来联接入流程。
• 系统接口无需立项即可使用。

注意事项

• 该接口为系统接口。不能用于处理玩家请求。

请求举例

curl "https://s1.livelink.qq.com/livelink/?apiName=ApiActList&livePlatId=egame&actId=0&gameId=cfm&v=2.0&t=1591148959&nonce=cb47fd7e&code=4%2FqMz8bSuoE%2F1WjIq0fhUgvM6%2BTfomvadEyYYF0aSG6NlvpfjSSF6NVXxkpKIAakuBV2TKMj5wgNATXoMjre745Nauw23PvAhoAkeRjnWMB3QWrrApEX0exuQjrN7DWB&sig=a46161e0504e93540bb113700a06782c"  -d '{"page":1,"size":2,"game":"cfm"}'

query参数说明

参数名称	参数类型	说明	必填	加入签名
apiName	string	值为: ApiActList	是	否
livePlatId	string	平台ID，由平台统一分配	是	是
actId	int	活动ID，可在腾讯游戏来联上分配	是	是
gameId	string	业务名称，见《业务代码》	是	是
v	float	版本号，当前最新版本为2.0	是	是
t	int	Unix时间戳，精度：秒	是	是
code	string	用户登录态。平台侧，可参考《平台侧接入》	是	是
nonce	string	随8位机字符串，字符串范围：0-9z-A	是	是
sig	string	签名，见《生成签名》	是	否

post参数说明

{
    "page": 1,
    "size": 2,
    "game": "cfm", // 为空则返回所有所有游戏的活动
    "isOnline": true // 传入true则只返回在线活动，默认为false返回所有活动
}

输出举例

{
    "iRet": 0,
    "sMsg": "ok",
    "v":2,
    "apiName":"ApiActList",
    "jData": {
        "actList": [{
            "id": 999, // 活动id
            "beginTime": "2020-10-21 00:00:00", // 开始时间
            "endTime": "2020-11-30 23:59:59", // 结束时间
            "game": "cfm", // 游戏业务码
            "actName": "cfm欢乐一夏" // 活动名称
        }, {
            "id": 998,
            "beginTime": "2020-10-20 00:00:00",
            "endTime": "2020-11-02 23:59:59",
            "game": "codm",
            "actName": "codm合作2期"
        }],
        "total": 220
    },
    "tid": "204594175939816199"
}