跳至主要内容

發送平台卡

發送指定卡片類型給玩家。

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

錯誤響應​

錯誤代碼​

狀態碼說明處理建議
5Game is not found遊戲不存在、已下線或不支援該幣別，請確認 gameCode 是否正確
8The User is not exist會員不存在，請先創建會員
78Operator card spinId was used請更換 spinId，若有疑問則聯絡客服處理
86Game is restricted請參考遊戲列表文件或詢問客服
87Invalid item parameter value重新確認參數規則或聯繫客服團隊
88Only one item can be active at a time in the same game請玩家重新進入對應遊戲使用後再發送
89The 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. 參數組合驗證：系統會驗證 itemBetInfo 中的參數組合是否正確
  3. 過期時間：expiredTime 必須為未來時間
  4. 卡片類型：cardType 必須與查詢平台卡資訊返回的類型匹配

相關 API​