發送 FeatureGame 平台卡

發送 FEATURE GAME 卡給指定玩家
補充：FEATURE GAME 卡 : 一般特色遊戲卡、強力特色遊戲卡、超強力特色遊戲卡

API 信息

• 端點：POST /v2/items/usesimplefeaturegame
• 認證：Bearer Token
• 加密：請求使用 AES-256-GCM 加密，響應為明文 JSON

請求

請求標頭

POST /v2/items/use HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
x-agentid: integratorNBTest04
x-timestamp: 1769746894501
x-nonce: 56ffd5ecd8a3a4457863a0bd7c298fb2
x-signature: 904e97bee2589b93e9747eed0346c68b23d8ff8b568dabaf4b94a5e89093df67

請求參數

解密後 Request

{
  "cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}

加密前的參數

{
   "username": "VPSysDevTest001",
   "spinId": "SystemItemTestTrans150",
   "gameCode": "VP_230001_1",
   "cardType": 11,
   "itemBet": 2,
   "maxWinAmount": 10,
   "expiredTime": "2026-04-12T00:00:00.000Z"
}

欄位	類型	必填	說明
username	string	是	玩家帳號
spinId	string	是	平台卡唯一識別碼
gameCode	string	是	遊戲代碼
cardType	number	是	卡片類型，可用參數
itemBet	number	否	平台卡下注金額，可參照 BetList 填寫，若未填寫則預設使用最小 Bet
maxWinAmount	number	否	最大贏得金額
expiredTime	string	否	卡片過期時間

響應

成功響應

{
   "code": 0,
   "message": "No error.",
   "data": {
       "itemId": "f2cb520579c8014452d6f521693a4aa8_VPItemTestTrans1042_ghjklhtombg"
   },
   "logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}

欄位	類型	說明
code	number	響應代碼，0 表示成功
message	string	響應訊息
data.itemId	string	系統內平台卡 ID
logUUID	string	請求追蹤 ID，用於問題排查和日誌查詢

錯誤響應

錯誤代碼

狀態碼	說明	處理建議
5	Game is not found	遊戲不存在、已下線或不支援該幣別，請確認 gameCode 是否正確
8	The User is not exist	會員不存在，請先創建會員
78	Operator card spinId was used	請更換 spinId，若有疑問則聯絡客服處理
86	Game is restricted	請參考遊戲列表文件或詢問客服
87	Invalid item parameter value	重新確認參數規則或聯繫客服團隊
88	Only one item can be active at a time in the same game	請玩家重新進入對應遊戲使用後再發送
89	The item has not been used yet, or the spinId does not exist	重新確認道具已使用或是道具已過期不存在

錯誤響應範例

平台卡參數組合錯誤

{
   "code": 87,
   "message": "Invalid item parameter value",
   "logUUID": "c6a85c7b-6108-4c88-95fb-fd79a1bda0a1"
}

平台卡 ID 重複使用

{
   "code": 78,
   "message": "The spinID was used",
   "logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}

注意事項

1. spinId 唯一性：每個 spinId 必須唯一，不可重複使用
2. 立即生效性：此 API 發送 FEATURE GAME 卡為當下立即生效

常見 QA

Q1: 該 API 發送 FEATURE GAME 是否有過期時間?

A: 發送後，若是玩家一直未登入遊戲使用，發送後的 12 小時將自動結算

Q2: 該 API 發送 FEATURE GAME 是否可以取消?

A: 可以，可透過 取消平台卡 API 取消，但需要在玩家尚未進入遊戲使用前或自動結算前，否則將不可取消

Q3: 自動結算後是否會告知玩家?

A: 玩家登入遊戲會顯示提醒獎勵訊息，但不會重新展示表演動畫

Q4: 若過期時間到了平台卡會自動結算還是取消?

A: 取消，且該平台卡 spinId 將無法再復用，後台與注單紀錄將無此筆資料

Q5: 若玩家於遊戲動畫中離開遊戲，FEATURE GAME 是否會自動結算?

A: 自動結算

相關 API

• 取消平台卡
• 查詢平台卡狀態
• 發送 FreeSpin 平台卡