- 依活動與渠道查詢派發卡,支援會員帳號過濾與分頁。
請求路徑
Headers
| 欄位 | 型別 | 必填 | 說明 |
|---|---|---|---|
Authorization | string | 是 | 驗證令牌,由我方提供 |
請求參數
| 欄位 | 型別 | 必填 | 參與簽章 | 說明 |
|---|---|---|---|---|
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 | |
data.grantList | object[] | 派發卡列表 |
data.grantList[].eventID | string | 活動編號 |
data.grantList[].grantID | string | 派發卡編號 |
data.grantList[].channelID | number | 渠道編號 |
data.grantList[].memberAccount | string | 會員帳號 |
data.grantList[].status | string | 狀態 (New / Active / Completed / Freeze / Expired / SettleFailed) |
data.grantList[].totalSpinTimes | number | 派發時贈送的免費旋轉次數 |
data.grantList[].usedSpinTimes | number | 已使用次數 |
data.grantList[].paidAmount | number | 已實際入錢包的派彩總額 |
data.grantList[].paidCount | number | 已派彩次數 |
data.grantList[].grantedAt | string | 派發卡建立時間 (時區、格式請參考API注意事項) |
data.grantList[].completedAt | string | 活動完成時間(未觸發為空) (時區、格式請參考API注意事項) |
data.grantList[].frozenAt | string | 凍結時間(未觸發為空) (時區、格式請參考API注意事項) |
data.grantList[].expiredAt | string | 到期時間 (時區、格式請參考API注意事項) |
data.nextToken | string | 下次查詢憑證(最後一次查詢返回空字串) |
data.maxResults | number | 返回限制筆數 |
data.total | number | 本次查詢總筆數 |
status | object | 回應狀態,請參考回應格式 |
