凍結免費轉活動 - VA Docs

凍結指定會員在此活動下的 grant。eventID / channelID / memberAccount 必填；grantID 選填。
有帶 grantID：僅凍結該張 (需同時屬於該 eventID 與該 memberAccount)。
未帶 grantID：凍結該會員此活動下所有可凍結 (New/Active) 的 grant。

請求路徑

POST {host}/vendor/v2.0/freespin/freeze

Headers

欄位	型別	必填	說明
`Authorization`	string	是	驗證令牌，由我方提供
`Content-Type`	string	是	`multipart/form-data`

請求參數

欄位	型別	必填	參與簽章	說明
`eventID`	string	是	✓	活動編號 (24 碼 hex)
`channelID`	number	是	✓	渠道編號(若無渠道，請帶入1)
`memberAccount`	string	是	✓	會員帳號(允許字元:`a-z A-Z 0-9 _-`)
`grantID`	string	否	✓	派發卡編號 (24 碼 hex)
`sign`	string	是		簽章，產生方式請參考簽章規則

回應

成功（HTTP 狀態碼固定為 200，請以 status.code 判斷結果）

欄位	型別	說明
`data`	object
`data.frozenGrants`	string[]	被凍結的 GrantID 清單
`status`	object	回應狀態，請參考回應格式

回應範例

{
  "data": {
    "frozenGrants": [
      "abccc1234567890aaaaa1254",
      "abccc1234567890aaaaa1231",
      "abccc1234567890aaaaa1299",
      "abccc1234567890aaaaa1288",
      "abccc1234567890aaaaa1277"
    ]
  },
  "status": {
    "code": "0",
    "message": "success",
    "datetime": "2022-07-01T10:13:54.920+08:00",
    "traceCode": "7cf25e1957cc47fe8e01f1a7c6d504d6"
  }
}

回應訊息碼

除了共通訊息碼，此 API 還可能回傳：

代碼	說明
`416`	查無此活動
`418`	會員不在此活動中
`429`	呼叫過於頻繁