Send Operator Card
Send the specified Card Type to the Player.
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
Decrypted Request
{
"cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
Parameters 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 Unique Identifier |
gameCode | string | Yes | Game Code |
expiredTime | string | Yes | Expiration Time |
round | number | Yes | Number of Rounds |
maxWinAmount | number | Yes | Maximum Win Amount |
itemBetInfo | object | Yes | Operator Card Bet Information |
itemBetInfo.itemBet | number | Yes | Operator Card Bet Amount |
itemBetInfo.freeSpinMultiple | number | Yes | Free Spin Multiplier |
itemBetInfo.lowerMultiple | number | Yes | Lower Multiplier |
itemBetInfo.upperMultiple | number | Yes | Upper Multiplier |
cardType | number | Yes | Card Type |
Response
Success Response
{
"code": 0,
"message": "No error.",
"data": {
"itemId": "f2cb520579c8014452d6f521693a4aa8_VPItemTestTrans1042_ghjklhtombg"
},
"logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}
Response Field Description
| Field | Type | Description |
|---|---|---|
data.itemId | string | System Operator Card ID |
Error Response
Error Codes
| Code | Description | Handling Suggestion |
|---|---|---|
| 5 | Game is not found | Game does not exist, is offline, or does not support the currency. Please confirm if the gameCode is correct. |
| 8 | The User is not exist | Player does not exist, please create the Player first. |
| 78 | Operator card spinId was used | Please change the spinId. If you have questions, please contact Customer Support for assistance. |
| 86 | Game is restricted | Please refer to the Game List document or inquire with Customer Support. |
| 87 | Invalid item parameter value | Reconfirm parameter rules or Contact Customer Support Team. |
| 88 | Only one item can be active at a time in the same game | Please ask the Player to re-enter the corresponding game and use it before resending. |
| 89 | The item has not been used yet, or the spinId does not exist | Reconfirm that the Item has been used or if the Item has expired/does not exist. |
Error Response Example
Operator Card Parameter Combination Error
{
"code": 87,
"message": "Invalid item parameter value",
"logUUID": "c6a85c7b-6108-4c88-95fb-fd79a1bda0a1"
}
Operator Card ID Duplicate Usage
{
"code": 78,
"message": "The spinID was used",
"logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}
Important Notes
- spinId Uniqueness: Each spinId must be unique and cannot be reused.
- Parameter Combination Validation: The system will validate if the parameter combination in itemBetInfo is correct.
- Expiration Time: expiredTime must be a future time.
- Card Type: cardType must match the Type returned by Get Operator Card Information.