营销活动变更回调
更新时间: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×tamp=1701964858687
请求体(body参数: application/json)示例
{
"activityId": "1000",
"channelId": "2974342",
"activityType": "TASK_REWARD",
"changeType": "CREATE"
}
如何设置
通过后台设置:
登录账户 - 进入【云直播】 - 点击【开发设置】- 点击【回调设置】- 营销活动变更回调
注意:提交的接口地址必须要以 http:// 或者 https:// 开头
