Send Simple FreeSpin Operator Card
Send FREE SPIN cards to specified Player
Supplement: FREE SPIN Card: Free Spin Card, Multiplier Free Spin Card (cardType 1, 2)
API Information
- URL：
POST /v2/items/usesimplefreespin - 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": "VPSysDevTest001",
"spinId": "SystemItemTestTrans150",
"gameCode": "VP_230001_1",
"round": 3,
"maxWinAmount": 10,
"itemBet": 2,
"multiple": 1
}
| Field | Type | Required | Description |
|---|---|---|---|
username | string | Yes | Player Account |
spinId | string | Yes | Operator Card Unique Identifier |
gameCode | string | Yes | Game Code |
round | number | Yes | Number of Rounds |
maxWinAmount | number | No | Maximum Win Amount |
itemBet | number | No | Operator Card Bet Amount, refer to BetList for details. If not specified, the minimum Bet will be used by default. |
multiple | number | No | Free Spin Multiplier, can be 1/2/3/5 times. If not specified, 1x will be used by default. |
Response
Success Response
{
"code": 0,
"message": "No error.",
"data": {
"itemId": "f2cb520579c8014452d6f521693a4aa8_VPItemTestTrans1042_ghjklhtombg"
},
"logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}
| Field | Type | Description |
|---|---|---|
code | number | Response code, 0 means Success |
message | string | Response message |
data.itemId | string | System Operator Card ID |
logUUID | string | Request tracking ID for troubleshooting and log queries |
Error Response
Error Codes
| Code | Description | Handling Suggestion |
|---|---|---|
| 5 | Game is not found | Games does not exist, is offline, or does not support the currency. Please confirm if 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 any questions, please contact Customer Support Team for assistance. |
| 86 | Game is restricted | Please refer to the Game List documentation or inquire with Customer Support Team. |
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.
- Immediate Effect: FREE SPIN Cards sent via this API take effect immediately.
Common QA
Q1: How to obtain the itemBet List in the sending parameters?
A: The complete supported list can be queried via Get Operator Card Information. You can also provide any value, and we will automatically select the closest and lower bet from the Games' betList to send.
Q2: Does the Free Spin sent by this API have an expiration time?
A: After sending, if the Player has not logged into Games to use it, it will automatically Settle 12 hours after sending.
Q3: Can the Free Spin sent by this API be canceled?
A: Yes, it can be canceled via the Cancel Operator Card API, but it must be done before the Player has entered Games to use it or before automatic Settlement. Otherwise, it cannot be canceled.
Q4: Will the Player be notified after automatic Settlement?
A: When the Player logs into Games, a reward notification message will be displayed, but the performance animation will not be re-displayed.