> ## Documentation Index
> Fetch the complete documentation index at: https://doc.va777.net/llms.txt
> Use this file to discover all available pages before exploring further.

# 建立免費場次

> [!NOTE]
>
> * 建立 FreeSpin 活動場次。

## 請求參數

**channelID** `number` *required*

渠道編號 (帶入0代表全部渠道)

**startTime** `string` *required*

開始時間 (時區、格式請參考[API注意事項](https://doc.va777.net/guides/request-format.md#時間格式))

**endTime** `string` *required*

結束時間 (時區、格式請參考[API注意事項](https://doc.va777.net/guides/request-format.md#時間格式))

**eventName** `string` *required*

活動名稱

**currency** `string` *required*

幣別(請洽詢我方商務)

**gameIDList** `number[]` *required*

可使用遊戲編號清單(至少帶 1 個，不可重複，每個皆須大於 0)（form-data 以同名欄位重複傳送多個值）

**minWithdraw** `string` *required*

派彩下限 (金額字串)(0.01\~999,999,999，小數最多 2 位)

**maxWithdraw** `string` *required*

派彩上限 (金額字串)(0.01\~999,999,999，小數最多 2 位，且須大於等於 minWithdraw)

**freeSpinTimes** `number` *required*

免費旋轉次數(須為 1\~99 的整數)

**validDays** `number` *required*

有效天數(1\~31)

**joinOptions** `string[]` *required*

加入方式(共 1\~2 項，不可重複，僅允許\[auto / add])。auto: 該平台渠道所有會員都能參加活動直到額滿，add: 透過[7.3 派發免費轉活動](https://doc.va777.net/api-reference/freespin/bind.md)指定會員參加活動直到額滿（form-data 以同名欄位重複傳送多個值）

**allowDuplicateJoin** `string`

是否允許同一會員取得多張派發卡 (true / false，空白視為 false)。當 joinOptions 含 auto 時，此欄位必須為 false。

**maxGrantCount** `number` *required*

派發卡張數上限(1\~99,999)

**maxGrantsPerMember** `number` *required*

單一會員派發卡上限(須大於等於 1)。當 allowDuplicateJoin=false 時必須為 1；當 allowDuplicateJoin=true 時須大於等於 1。

**bet** `string` *required*

每轉下注金額 (金額字串)(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` *required*

簽章，產生方式請參考[簽章規則](https://doc.va777.net/guides/signature.md)

## 回應

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

**data** `object`

**屬性**

**eventID** `string`

活動編號 (24 碼 hex)

**status** `object`

每次回應都會附帶的請求處理狀態

**屬性**

**code** `string`

回應訊息碼，請參照[回應訊息碼](https://doc.va777.net/reference/response-codes.md)

**message** `string`

回應詳細訊息

**datetime** `string`

請求接收時間，格式為 RFC3339

**traceCode** `string`

回應追蹤碼（唯一值），供雙方比對回應內容

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.