Send Operator Card
Send a specified Card Type to 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 winning 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, has been delisted, or does not support the currency; please confirm gameCode is correct |
| 8 | The User is not exist | Player does not exist, please create Player first |
| 78 | Operator card spinId was used | Please change spinId; if you have questions, contact Customer Support |
| 86 | Game is restricted | Please refer to the Game List document or inquire with Customer Support |
Error Response Example
Operator Card Parameter Combination Error
{
"code": 7,
"message": "Internal server error",
"error": "{\"retStatus\":{\"StatusCode\":80013,\"StatusMsg\":\"RiskInfoError\",\"CheckCode\":0,\"SystemTime\":1760348424576}}",
"logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}
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 verify 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