跳至主要内容

發送平台卡

為會員使用指定的平台卡。

API 信息​

  • 端點：POST /v2/items/use
  • 認證：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": "testaccount001",
   "spinId": "VPItemTestTrans1024_ghjklhtombg",
   "gameCode": "VP_230001_1",
   "expiredTime": "2025-10-25T17:03:20.000Z",
   "round": 3,
   "maxWinAmount": 0.1,
   "itemBetInfo":{
       "itemBet":0.1,
       "freeSpinMultiple":1,
       "lowerMultiple": 1,
       "upperMultiple": 8
   },
   "cardType":1
}
欄位類型必填說明
usernamestring是會員帳號
spinIdstring是平台卡唯一識別碼
gameCodestring是遊戲代碼
expiredTimestring是過期時間
roundnumber是回合數
maxWinAmountnumber是最大贏得金額
itemBetInfoobject是平台卡下注信息
itemBetInfo.itemBetnumber是平台卡下注金額
itemBetInfo.freeSpinMultiplenumber是免費旋轉倍數
itemBetInfo.lowerMultiplenumber是下限倍數
itemBetInfo.upperMultiplenumber是上限倍數
cardTypenumber是卡片類型

響應​

成功響應​

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

響應欄位說明​

欄位類型說明
data.itemIdstring系統內平台卡 ID

錯誤響應​

平台卡參數組合錯誤​

{
   "code": 7,
   "message": "Internal server error",
   "error": "{\"retStatus\":{\"StatusCode\":80013,\"StatusMsg\":\"RiskInfoError\",\"CheckCode\":0,\"SystemTime\":1760348424576}}",
   "logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}

平台卡 ID 重複使用​

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

常見錯誤碼​

狀態碼說明
7內部伺服器錯誤（可能包含詳細錯誤信息）
8會員不存在
11參數錯誤
78spinID 已被使用
83認證失敗
84解密失敗

注意事項​

  1. spinId 唯一性：每個 spinId 必須唯一，不可重複使用
  2. 參數組合驗證：系統會驗證 itemBetInfo 中的參數組合是否正確
  3. 過期時間：expiredTime 必須為未來時間
  4. 卡片類型：cardType 必須與查詢平台卡資訊返回的類型匹配

相關 API​