Use Operator Card
Use a specified item for a member.
API Information
- URL：
POST /v2/items/use - Authentication：Bearer Token
- Encryption：Requests are encrypted using AES-256-GCM; responses are returned as plaintext JSON
request
request Headers
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 Parameters
Encrypted Request Body
{
"cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
Request Body Before Encryption
{
"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
}
| Field | Type | Required | Description |
|---|---|---|---|
username | string | Yes | Player Account |
spinId | string | Yes | Operator Card ID |
gameCode | string | Yes | Game Code |
expiredTime | string | Yes | Operator Card Expiration Time |
round | number | Yes | Spin Rounds |
maxWinAmount | number | Yes | Maximum Obtainable Winning Points for Operator Card |
itemBetInfo | object | Yes | Item Configuration Parameters |
itemBetInfo.itemBet | number | Yes | betAmount Used for Operator Card |
itemBetInfo.freeSpinMultiple | number | Yes | Operator Card Multiplier Range |
itemBetInfo.lowerMultiple | number | Yes | Winning Points Lower Limit |
itemBetInfo.upperMultiple | number | Yes | Winning Points Upper Limit |
cardType | number | Yes | Card Types |
Response
Success Response
{
"code": 0,
"message": "No error.",
"data": {
"itemId": "f2cb520579c8014452d6f521693a4aa8_VPItemTestTrans1042_ghjklhtombg"
},
"logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}
| Field | Type | Description |
|---|---|---|
code | number | Status code |
message | string | Status message |
data.itemId | string | System Operator Card ID |
logUUID | string | Request tracking ID for troubleshooting and log queries |
Error Response
Invalid platform card parameter combination.
{
"code": 7,
"message": "Internal server error",
"error": "{\"retStatus\":{\"StatusCode\":80013,\"StatusMsg\":\"RiskInfoError\",\"CheckCode\":0,\"SystemTime\":1760348424576}}",
"logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}
Duplicate use of platform spinID.
{
"code": 78,
"message": "The spinID was used",
"logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}
Common Error Codes
| Code | Description |
|---|---|
| 7 | Internal server error |
| 8 | The member does not exist |
| 11 | Parameters error |
| 78 | The spinId has already been used |
| 83 | Authentication Failed |
| 84 | Decryption Failed |
Important Notes
- spinId Uniqueness: Each
spinIdmust be unique and cannot be reused - Parameter Combination Validation: The system will validate whether the parameter combination in
itemBetInfois correct - Expiration Time:
expiredTimemust be set to a future time - Card Type:
cardTypemust match the type returned by the Get Operator Card Information API