- 將 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
| 欄位 | 型別 | 必填 | 說明 |
|---|---|---|---|
Authorization | string | 是 | 驗證令牌,由我方提供 |
Content-Type | string | 是 | multipart/form-data |
請求參數
| 欄位 | 型別 | 必填 | 參與簽章 | 說明 |
|---|---|---|---|---|
channelID | number | 是 | ✓ | 渠道編號 (若無渠道,請帶入1) |
eventID | string | 是 | ✓ | 活動編號 (24 碼 hex) |
memberList | string[] | 是 | ✓ | 會員帳號列表(至少帶 1 個,不可重複,每個不可為空字串)(form-data 以同名欄位重複傳送多個值) |
sign | string | 是 | 簽章,產生方式請參考簽章規則 |
回應
成功(HTTP 狀態碼固定為 200,請以status.code 判斷結果)
| 欄位 | 型別 | 說明 |
|---|---|---|
data | object | |
data.grants | object[] | 發放結果 (整批成功才會有) |
data.grants[].memberAccount | string | 會員帳號 |
data.grants[].grantID | string | 派發卡編號 (24 碼 hex) |
status | object | 回應狀態,請參考回應格式 |
