取得免費旋轉派發卡列表

GET /vendor/v2.0/freespin/grant

取得免費旋轉派發卡列表

cURL

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

200

{
  "data": {
    "grantList": [
      {
        "eventID": "qwertyuiop1234569876541",
        "grantID": "zaqwsxcder1234569879999",
        "channelID": 1,
        "memberAccount": "test123",
        "status": "Active",
        "totalSpinTimes": 50,
        "usedSpinTimes": 48,
        "paidAmount": 12.34,
        "paidCount": 45,
        "grantedAt": "2022-07-01T10:13:54.920+08:00",
        "completedAt": null,
        "frozenAt": null,
        "expiredAt": null
      }
    ],
    "nextToken": "gdfv5451gg5574fs",
    "maxResults": 2000,
    "total": 1
  },
  "status": {
    "code": "0",
    "message": "success",
    "datetime": "2022-07-01T10:13:54.920+08:00",
    "traceCode": "7cf25e1957cc47fe8e01f1a7c6d504d6"
  }
}

• 依活動與渠道查詢派發卡，支援會員帳號過濾與分頁。

​

請求參數

channelID · number · 必填 · 參與簽章

渠道編號(若無渠道，請帶入1)

eventID · string · 必填 · 參與簽章

活動編號 (24 碼 hex)

memberAccount · string · 參與簽章

會員帳號(允許字元:a-z A-Z 0-9 _-)

nextToken · string · 參與簽章

查詢憑證 (初次查詢帶入空白，之後應帶入前一次結果的nextToken)

maxResults · number · 必填 · 參與簽章

返回限制筆數 (最小2000筆，最大5000筆)

sign · string · 必填

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

​

回應

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

data · object

顯示 屬性

grantList · object[]

派發卡列表

顯示 屬性

eventID · string

活動編號

grantID · string

派發卡編號

channelID · number

渠道編號

memberAccount · string

會員帳號

status · string

狀態 (New / Active / Completed / Freeze / Expired / SettleFailed)

totalSpinTimes · number

派發時贈送的免費旋轉次數

usedSpinTimes · number

已使用次數

paidAmount · number

已實際入錢包的派彩總額

paidCount · number

已派彩次數

grantedAt · string

派發卡建立時間 (時區、格式請參考API注意事項)

completedAt · string

活動完成時間(未觸發為空) (時區、格式請參考API注意事項)

frozenAt · string

凍結時間(未觸發為空) (時區、格式請參考API注意事項)

expiredAt · string

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

nextToken · number

下次查詢憑證(最後一次查詢返回空字串)

maxResults · number

返回限制筆數

total · number

本次查詢總筆數

status · object

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

顯示 屬性

code · string

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

message · string

回應詳細訊息

datetime · string

請求接收時間，格式為 RFC3339

traceCode · string

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

200

{
  "data": {
    "grantList": [
      {
        "eventID": "qwertyuiop1234569876541",
        "grantID": "zaqwsxcder1234569879999",
        "channelID": 1,
        "memberAccount": "test123",
        "status": "Active",
        "totalSpinTimes": 50,
        "usedSpinTimes": 48,
        "paidAmount": 12.34,
        "paidCount": 45,
        "grantedAt": "2022-07-01T10:13:54.920+08:00",
        "completedAt": null,
        "frozenAt": null,
        "expiredAt": null
      }
    ],
    "nextToken": "gdfv5451gg5574fs",
    "maxResults": 2000,
    "total": 1
  },
  "status": {
    "code": "0",
    "message": "success",
    "datetime": "2022-07-01T10:13:54.920+08:00",
    "traceCode": "7cf25e1957cc47fe8e01f1a7c6d504d6"
  }
}