Skip to main content

Query Operator Card Status

Query the current Status of a sent Operator Card

API Information​

  • URL：POST /v2/items/state
  • Authentication：Bearer Token
  • Encryption：Requests are encrypted using AES-256-GCM; responses are returned as plaintext JSON

request​

Request Headers​

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

Request Parameters​

Parameters Before Encryption​

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

Encrypted Request Body​

{
  "cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
FieldTypeRequiredDescription
usernamestringConditionalPlayer Account (Required when used in combination with spinId)
spinIdstringConditionalOperator Card Unique Identifier (Required when used in combination with username)
itemIdstringConditionalSystem Operator Card ID (Required when used alone)

Response​

Success Response​

{
   "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"
}

Response Field Description​

FieldTypeDescription
data.winnumberCurrent Win Amount
data.usernamestringPlayer Account
data.expiredTimestringExpiration Time
data.itemIdstringSystem Operator Card ID

Error Response​

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

Common Error Codes​

CodeDescription
4The transaction doesn't exist
8Player doesn't exist
11Parameters error
83Authentication Failed
84Decryption Failed

Important Notes​

  1. Query Method: Can query using one of two combinations
    • Method One: username + spinId
    • Method Two: itemId
  2. Parameter Combination: Must provide a complete parameter combination, cannot mix and match
  3. Real-time Data: Returns the latest usage status of the current Operator Card