行銷活動變更回調
更新時間：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:// 開頭
