调用 ListActivityBonusTaskWinners 接口，在指定直播间内查询直播福利任务获奖名单。

注意事项 #

• 请求频率：单用户请求频率限制为 10 次/秒。
• 前提条件：确保您拥有火山引擎主账号或具备直播间的数据统计 > 可查看权限的子账号。有关如何添加子账号，详见子账号管理。
• 使用限制：仅支持查询 60 天内的直播福利任务的获奖名单。

请求说明 #

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

调试 #

请求参数 #

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

Query #

返回参数 #

Winners #

BonusDetail #

SubBonus #

AwardSubBonus #

CouponSubBonus #

PointSubBonus #

CashSubBonus #

请求示例 #

GET https://livesaas.volcengineapi.com/?Action=ListActivityBonusTaskWinners&Version=2023-08-01&ActivityId=181531561531&Id=181531561532&PageNumber=1&PageSize=10

返回示例 #

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "ListActivityBonusTaskWinners",
        "Version": "2023-08-01",
        "Service": "livesaas",
        "Region": "cn-north-1",
        "SystemTime": 1697446406
    },
    "Result": {
        "Winners": [
            {
                "UserId": 123451239,
                "ExternalUserId": "1437224142",
                "NickName": "观众 A",
                "FinishTime": 1764672341,
                "Email": "zhibo@xxx.com",
                "AwardTel": "+86188****1217",
                "AwardEmail": "example2@example.com",
                "BonusIndex": 0,
                "ReceiverName": "小明",
                "Tel": "188****1456",
                "AwardAddress": "上海市xxxxx",
                "BonusDetail": {
                    "SubTaskType": 1,
                    "SubTaskCondition": 10,
                    "SubBonusType": 1,
                    "SubBonus": {
                        "AwardSubBonus": {
                            "AwardItemId": 1715,
                            "DeliveryMethod": 1,
                            "AwardLotteryTicketAddr": "https://example.com",
                            "AwardItemAmounts": 1,
                            "AwardItemType": 1,
                            "AwardItemName": "电子手表",
                            "AwardItemIcon": "https://www.example.com/test.png",
                            "AwardItemNum": "48151841",
                            "LimitCount": -1,
                            "WinnerInfoType": [
                                null
                            ]
                        },
                        "PointSubBonus": {
                            "AmountTenthsUnit": 10,
                            "LimitCount": -1
                        },
                        "CouponSubBonus": {
                            "CouponId": 18156156151458,
                            "CouponPic": "https://www.example.com/a.png",
                            "CouponThirdPartyId": "45535343****444444",
                            "CouponDescription": "满100减20",
                            "CouponName": "鸡蛋优惠券",
                            "LimitCount": -1
                        },
                        "CashSubBonus": {
                            "AmountTenthsUnit": 10,
                            "LimitCount": -1
                        }
                    }
                }
            }
        ],
        "Total": 32
    }
}

错误码 #

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