建立免費場次 - VA Docs

建立 FreeSpin 活動場次。

請求路徑

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

Headers

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

請求參數

欄位	型別	必填	參與簽章	說明
`channelID`	number	是	✓	渠道編號 (帶入0代表全部渠道)
`startTime`	string	是	✓	開始時間 (時區、格式請參考API注意事項)
`endTime`	string	是	✓	結束時間 (時區、格式請參考API注意事項)
`eventName`	string	是	✓	活動名稱
`currency`	string	是	✓	幣別(請洽詢我方商務)
`gameIDList`	number[]	是	✓	可使用遊戲編號清單(至少帶 1 個，不可重複，每個皆須大於 0)（form-data 以同名欄位重複傳送多個值）
`minWithdraw`	string	是	✓	派彩下限 (金額字串)(0.01~999,999,999，小數最多 2 位)
`maxWithdraw`	string	是	✓	派彩上限 (金額字串)(0.01~999,999,999，小數最多 2 位，且須大於等於 minWithdraw)
`freeSpinTimes`	number	是	✓	免費旋轉次數(須為 1~99 的整數)
`validDays`	number	是	✓	有效天數(1~31)
`joinOptions`	string[]	是	✓	加入方式(共 1~2 項，不可重複，僅允許[auto / add])。auto: 該平台渠道所有會員都能參加活動直到額滿，add: 透過7.3 派發免費轉活動指定會員參加活動直到額滿（form-data 以同名欄位重複傳送多個值）
`allowDuplicateJoin`	string	否	✓	是否允許同一會員取得多張派發卡 (true / false，空白視為 false)。當 joinOptions 含 auto 時，此欄位必須為 false。
`maxGrantCount`	number	是	✓	派發卡張數上限(1~99,999)
`maxGrantsPerMember`	number	是	✓	單一會員派發卡上限(須大於等於 1)。當 allowDuplicateJoin=false 時必須為 1；當 allowDuplicateJoin=true 時須大於等於 1。
`bet`	string	是	✓	每轉下注金額 (金額字串)(0.01~999,999,999，小數最多 2 位)
`zoneID`	string	否	✓	前台展示時區 (GMT-12~GMT+12，空白視為 GMT+8)
`giftCodes`	string	否	✓	兌換碼 (暫不支援，僅 joinOptions 含 add 時生效)。JSON 字串格式：[{“code”:“GC2024NY”,“total”:100}]；code 為 5~10 碼英數字；total 須為大於等於 1 的整數。
`settlePerSpin`	string	否	✓	結算模式(true / false，true代表每轉皆派彩，空白視為 false)
`sign`	string	是		簽章，產生方式請參考簽章規則

回應

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

欄位	型別	說明
`data`	object
`data.eventID`	string	活動編號 (24 碼 hex)
`status`	object	回應狀態，請參考回應格式

回應範例

{
  "data": {
    "eventID": "abccc1234567890aaaaa1254"
  },
  "status": {
    "code": "0",
    "message": "success",
    "datetime": "2022-07-01T10:13:54.920+08:00",
    "traceCode": "7cf25e1957cc47fe8e01f1a7c6d504d6"
  }
}

回應訊息碼

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

代碼	說明
`206`	遊戲不存在
`429`	呼叫過於頻繁