跳到主要内容

发送平台卡

为会员使用指定的平台卡。

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"
}
欄位类型说明
codenumber响应代码，0 表示成功
messagestring响应讯息
data.itemIdstring系统內平台卡 ID
logUUIDstring请求追蹤 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​