取得免費旋轉活動列表

GET /vendor/v2.0/freespin/eventList

取得免費旋轉活動列表

cURL

curl --request GET \
  --url https://your-api-host/vendor/v2.0/freespin/eventList \
  --header 'Authorization: <api-key>'

200

{
  "data": {
    "list": [
      {
        "eventID": "6aa7983a9e2d5ae80b536e48",
        "eventName": "Summer Free Spin",
        "startDate": "2026-09-14T02:45:000+08:00",
        "endDate": "2026-09-15T02:45:00.999+08:00",
        "channelID": 1,
        "currency": "CNY",
        "gameIDList": [
          24
        ],
        "minWithdraw": 0.01,
        "maxWithdraw": 99999999,
        "freeSpinTimes": 1,
        "validDays": 1,
        "joinOptions": [
          "auto"
        ],
        "allowDuplicateJoin": false,
        "maxGrantCount": 1,
        "maxGrantsPerMember": 1,
        "bet": 1,
        "zoneID": "GMT+8",
        "settlePerSpin": false,
        "createTime": "2026-09-14T02:46:18.982+08:00"
      }
    ],
    "total": 1
  },
  "status": {
    "code": "0",
    "message": "success",
    "datetime": "2022-07-01T10:13:54.920+08:00",
    "traceCode": "7cf25e1957cc47fe8e01f1a7c6d504d6"
  }
}

• 依開始時間與結束時間查詢活動列表。

​

請求參數

startTime · string · 必填 · 參與簽章

開始時間 (時區、格式請參考API注意事項)

endTime · string · 必填 · 參與簽章

結束時間 (時區、格式請參考API注意事項)

eventID · string · 參與簽章

活動編號 (24 碼 hex)

sign · string · 必填

簽章，產生方式請參考簽章規則

​

回應

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

data · object

顯示 屬性

list · object[]

活動列表

顯示 屬性

eventID · string

活動編號

eventName · string

活動結束時間

startTime · string

活動開始時間

channelID · number

渠道編號

currency · string

幣別

gameIDList · number[]

可玩遊戲清單

minWithdraw · number

派彩下限

maxWithdraw · number

派彩上限

freeSpinTimes · number

每張派發卡的免費旋轉次數

validDays · number

派發後有效天數

joinOptions · string[]

加入方式

allowDuplicateJoin · boolean

是否允許同會員多張派發卡

maxGrantCount · number

派發卡張數上限

maxGrantsPerMember · number

單一會員派發卡張數上限

bet · number

每轉下注

zoneID · string

前台展示時區 (GMT-12~GMT+12)

settlePerSpin · boolean

結算模式

createTime · string

建立時間

total · number

本次查詢總筆數

status · object

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

顯示 屬性

code · string

回應訊息碼，請參照回應訊息碼

message · string

回應詳細訊息

datetime · string

請求接收時間，格式為 RFC3339

traceCode · string

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

200

{
  "data": {
    "list": [
      {
        "eventID": "6aa7983a9e2d5ae80b536e48",
        "eventName": "Summer Free Spin",
        "startDate": "2026-09-14T02:45:000+08:00",
        "endDate": "2026-09-15T02:45:00.999+08:00",
        "channelID": 1,
        "currency": "CNY",
        "gameIDList": [
          24
        ],
        "minWithdraw": 0.01,
        "maxWithdraw": 99999999,
        "freeSpinTimes": 1,
        "validDays": 1,
        "joinOptions": [
          "auto"
        ],
        "allowDuplicateJoin": false,
        "maxGrantCount": 1,
        "maxGrantsPerMember": 1,
        "bet": 1,
        "zoneID": "GMT+8",
        "settlePerSpin": false,
        "createTime": "2026-09-14T02:46:18.982+08:00"
      }
    ],
    "total": 1
  },
  "status": {
    "code": "0",
    "message": "success",
    "datetime": "2022-07-01T10:13:54.920+08:00",
    "traceCode": "7cf25e1957cc47fe8e01f1a7c6d504d6"
  }
}