作用 #

当观众在观看页完成福利任务中的一个或多个子任务并收到奖励后，企业直播会向您设置的回调地址发送回调消息。

配置方式 #

完成回调配置。详见回调配置。

回调频率限制 #

每个福利任务的回调频率限制为 8 次/秒。

详情 #

完成回调配置后，当观众在观看页完成任务获得奖励时，企业直播会将直播间 ID、直播福利 ID 以及接收奖励的观众信息以 POST 方式提交给您设置的回调地址。如果福利任务中包含多个子任务，企业直播将分别发送每个子任务的回调消息。单次回调最多包含 1000 条接收奖励的观众信息，若某个福利任务奖励的获取观众信息超过该上限，企业直播将分多次发送回调消息。
请求示例如下所示：

POST /xxxxx HTTP/1.1
Header1: ...
Header2: ...
...
{
    "AccountId": "20000*****",
    "ActivityId": "182845*****86724",
    "EventType": "ActivityUserReceiveActivityBonusBatchCallBack",
    "Id": "18287*****81612",
    "RequestUuid": "ActivityUserReceiveActivityBonusBatchCallBack-1828723*****4044",
    "Sign": "f51eb4cc55f93d****10947f909689bb",
    "SubAccountName": "admin@bytedance.com",
    "UserInfos": [
        {
            "ExternalUserId": "42709****587552",
            "FinishTime": "1744019364",
            "UserId": "175155****397136",
            "UserNickName": "观众 A",
            "BonusIndex": 0,
        },
        {
            "ExternalUserId": "jy**hh",
            "FinishTime": "1744019365",
            "UserId": "182867****93812",
            "UserNickName": "观众 B",
            "BonusIndex": 1

        }
    ]
}

超时重试 #

回调服务器在发送消息通知后，5 秒内没有收到您的服务器的响应，即认为通知失败。后续会以 5 秒为间隔继续重试 2 次。

参数 #

UserActivityBonusInfo #