跳轉到主要內容
  • 依活動與渠道查詢派發卡,支援會員帳號過濾與分頁。

請求路徑

Headers

欄位型別必填說明
Authorizationstring是驗證令牌,由我方提供

請求參數

欄位型別必填參與簽章說明
channelIDnumber是✓渠道編號(若無渠道,請帶入1)
eventIDstring是✓活動編號 (24 碼 hex)
memberAccountstring否✓會員帳號(允許字元:a-z A-Z 0-9 _-)
nextTokenstring否✓查詢憑證 (初次查詢帶入空白,之後應帶入前一次結果的nextToken)
maxResultsnumber是✓返回限制筆數 (最小2000筆,最大5000筆)
signstring是簽章,產生方式請參考簽章規則

回應

成功(HTTP 狀態碼固定為 200,請以 status.code 判斷結果)
欄位型別說明
dataobject
data.grantListobject[]派發卡列表
data.grantList[].eventIDstring活動編號
data.grantList[].grantIDstring派發卡編號
data.grantList[].channelIDnumber渠道編號
data.grantList[].memberAccountstring會員帳號
data.grantList[].statusstring狀態 (New / Active / Completed / Freeze / Expired / SettleFailed)
data.grantList[].totalSpinTimesnumber派發時贈送的免費旋轉次數
data.grantList[].usedSpinTimesnumber已使用次數
data.grantList[].paidAmountnumber已實際入錢包的派彩總額
data.grantList[].paidCountnumber已派彩次數
data.grantList[].grantedAtstring派發卡建立時間 (時區、格式請參考API注意事項)
data.grantList[].completedAtstring活動完成時間(未觸發為空) (時區、格式請參考API注意事項)
data.grantList[].frozenAtstring凍結時間(未觸發為空) (時區、格式請參考API注意事項)
data.grantList[].expiredAtstring到期時間 (時區、格式請參考API注意事項)
data.nextTokenstring下次查詢憑證(最後一次查詢返回空字串)
data.maxResultsnumber返回限制筆數
data.totalnumber本次查詢總筆數
statusobject回應狀態,請參考回應格式

回應範例

回應訊息碼

除了共通訊息碼,此 API 還可能回傳: