查询平台卡状态

查询已发送平台卡的当前状态和流水进度。

API 信息

• 端点：POST /v2/items/state
• 认证：Bearer Token
• 加密：请求使用 AES-256-GCM 加密，响应为明文 JSON

请求

请求标头

POST /v2/items/state 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

请求参数

加密前的参数

{
   "username": "testaccount001",
   "spinId": "VPItemTestTrans1015_ghjklhtombg",
   "itemId": "testuser"
}

加密后的请求体

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

欄位	类型	必填	说明
username	string	条件	会员账号（与 spinId 组合使用时必填）
spinId	string	条件	平台卡唯一識别码（与 username 组合使用时必填）
itemId	string	条件	系统內平台卡 ID（单獨使用时必填）

响应

成功响应

{
   "code": 0,
   "message": "No error.",
   "data": {
       "win": 2.64,
       "username": "integratorNBTest04_VPSysDevTest002",
       "expiredTime": "2025-10-25T17:03:20.000Z",
       "itemId": "e60926515661dac5bbb611e042dfed2b_VPItemTestTrans1036_ghjklhtombg"
   },
   "logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}

响应欄位说明

欄位	类型	说明
data.win	number	当前贏得金额
data.username	string	会员账号
data.expiredTime	string	过期时间
data.itemId	string	系统內平台卡 ID

错误响应

{
  "code": 4,
  "message": "The transaction doesn`t exist.",
  "logUUID": "6589bf8d-fe74-48bd-841a-71bf8f848f86"
}

常見错误码

状态码	说明
4	交易不存在
8	会员不存在
11	参数错误
83	认证失敗
84	解密失敗

注意事项

1. 查询方式：可以使用兩种组合择一查询
   • 方式一：username + spinId
   • 方式二：itemId
2. 参数组合：必须提供完整的参数组合，不可混用
3. 实时数据：返回当前平台卡的最新使用状态

相关 API

• 发送平台卡
• 取消平台卡