跳到主要内容

发送平台卡

发送指定卡片类型给玩家。

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​