保利威文档中心

帮助中心

营销活动变更回调

更新时间:2025-04-21 15:21:49

作用

用户创建、修改营销活动(任务奖励、抽奖)后,服务端会对客户所设置的接口地址,以POST方式提交任务处理情况到用户自定义的回调接口。

回调失败重试

  • 接口如果没有返回 http status 200 状态码, 会认为用户处理本次回调失败,针对失败的情况, 会重试3次回调

回调参数说明

营销活动变更回调

  • 请求方式: POST

URL参数

参数名 类型及范围 说明
timestamp long 13位时间戳
sign string 签名, 签名生成的规则是MD5(appSecret + timestamp), 为防止回调请求伪造, 请务必校验sign值的正确性

BODY参数:

参数名 类型及范围 说明
activityId String 活动ID
channelId string 频道ID
activityType string 活动类型(TASK_REWARD:任务奖励,LOTTERY_ACTIVITY:抽奖模板,LOTTERY:发起抽奖)
changeType string 变更类型(CREATE:创建,MODIFY:修改,DELETE:删除)

回调数据示例

请求地址示例: https://www.example.com/xxx/callback?sign=d5079f2e8ba19e49bfd3d9575866d80f&timestamp=1701964858687

请求体(body参数: application/json)示例

{
  "activityId": "1000",
  "channelId": "2974342",
  "activityType": "TASK_REWARD",
  "changeType": "CREATE"
}

如何设置

通过后台设置:

登录账户 - 进入【云直播】 - 点击【开发设置】- 点击【回调设置】- 营销活动变更回调

注意:提交的接口地址必须要以 http:// 或者 https:// 开头

联系客服,在线咨询