跳轉到主要內容
  • 將 memberList 內的會員整批派發派發卡 (joinOptions=add),整批成功或整批失敗 (all-or-nothing)。
  • 任一會員不存在 → 整批拒絕,回 ACCOUNT_DOES_NOT_EXIST,errorMessage 帶不存在的會員帳號。
  • 名額檢查:若 (目前已派發數 + 本次 memberList 筆數) 超過活動 maxGrantCount,整批拒絕,回 FREESPIN_QUOTA_FULL。
  • 任一會員已綁定 (allowDuplicateJoin=false) 或達單人上限 (max_grants_per_member) → 整批拒絕,回 BAD_PARAMETERS,錯誤訊息帶違規會員。
  • 活動狀態異常 (不存在 / 未啟用 / 已過期 / 幣別不符) → 整批拒絕,回 FREESPIN_EVENT_NOT_FOUND 或 BAD_PARAMETERS。
  • 成功則回 grants:每筆皆含 grantID 與 memberAccount。

請求路徑

Headers

欄位型別必填說明
Authorizationstring是驗證令牌,由我方提供
Content-Typestring是multipart/form-data

請求參數

欄位型別必填參與簽章說明
channelIDnumber是✓渠道編號 (若無渠道,請帶入1)
eventIDstring是✓活動編號 (24 碼 hex)
memberListstring[]是✓會員帳號列表(至少帶 1 個,不可重複,每個不可為空字串)(form-data 以同名欄位重複傳送多個值)
signstring是簽章,產生方式請參考簽章規則

回應

成功(HTTP 狀態碼固定為 200,請以 status.code 判斷結果)
欄位型別說明
dataobject
data.grantsobject[]發放結果 (整批成功才會有)
data.grants[].memberAccountstring會員帳號
data.grants[].grantIDstring派發卡編號 (24 碼 hex)
statusobject回應狀態,請參考回應格式

回應範例

回應訊息碼

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