调用GetActivityBonusTask接口，在指定直播间内查询指定直播福利任务详情。

注意事项 #

• 请求频率：单用户请求频率限制为 10 次/秒。
• 前提条件：确保您拥有火山引擎主账号或具备直播间的营销互动 > 可查看权限的子账号。有关如何添加子账号，详见子账号管理。

请求说明 #

• 请求方式：GET
• 请求地址：https://livesaas.volcengineapi.com/?Action=GetActivityBonusTask&Version=2023-08-01

调试 #

请求参数 #

下表仅列出该接口特有的请求参数和部分公共参数。更多信息详见公共参数。

Query #

返回参数 #

ActivityBonusTasks #

BonusList #

SubBonus #

PointSubBonus #

CashSubBonus #

CouponSubBonus #

AwardSubBonus #

请求示例 #

GET https://livesaas.volcengineapi.com/?Action=GetActivityBonusTask&Version=2023-08-01&ActivityId=181561561564&Id=181761651458

返回示例 #

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "GetActivityBonusTask",
        "Version": "2023-08-01",
        "Service": "livesaas",
        "Region": "cn-north-1",
        "SystemTime": 1697446406
    },
    "Result": {
        "ActivityBonusTasks": {
            "Id": 183738221212,
            "BonusList": [
                {
                    "SubTaskType": 1,
                    "SubTaskCondition": 10,
                    "SubBonusType": 1,
                    "SubBonus": {
                        "CouponSubBonus": {
                            "CouponId": 18156156151458,
                            "CouponPic": "https://www.example.com/a.png",
                            "CouponThirdPartyId": "45535343****444444",
                            "CouponDescription": "满100减20",
                            "CouponName": "鸡蛋优惠券",
                            "LimitCount": -1
                        },
                        "PointSubBonus": {
                            "AmountTenthsUnit": 10,
                            "LimitCount": -1
                        },
                        "CashSubBonus": {
                            "AmountTenthsUnit": 10,
                            "LimitCount": -1
                        },
                        "AwardSubBonus": {
                            "AwardItemId": 1715,
                            "DeliveryMethod": 1,
                            "AwardLotteryTicketAddr": "https://example.com",
                            "AwardItemAmounts": 1,
                            "AwardItemType": 1,
                            "AwardItemName": "电子手表",
                            "AwardItemIcon": "https://www.example.com/test.png",
                            "AwardItemNum": "48151841",
                            "WinnerInfoType": [
                                null
                            ],
                            "LimitCount": -1
                        }
                    }
                }
            ],
            "Status": 1,
            "ActualStartTime": 1764657022,
            "TaskRunningType": 2,
            "EndTime": 1764657098,
            "Name": "看直播，领好礼",
            "StartTime": 1764657022,
            "ActualEndTime": 1764657098
        }
    }
}

错误码 #

访问公共错误码和错误码获取详细信息。