Send Simple FeatureGame Operator Card
Send FEATURE GAME Card to the specified Player Note: FEATURE GAME Cards: Regular Feature Games Card, Powerful Feature Games Card, Super Powerful Feature Games Card
API Information
- URL：
POST /v2/items/usesimplefeaturegame - 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",
"cardType": 11,
"itemBet": 2,
"maxWinAmount": 10,
}
| Field | Type | Required | Description |
|---|---|---|---|
username | string | Yes | Player Account |
spinId | string | Yes | Operator Card Unique Identifier |
gameCode | string | Yes | Game Code |
cardType | number | Yes | Card Type, available parameters: 11, 21, 22 |
maxWinAmount | number | No | Maximum Win Amount |
itemBet | number | No | Operator Card Bet Amount, can be filled by referring to BetList. If not filled, the minimum Bet 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 | Game does not exist, has been delisted, or does not support this currency. Please confirm 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 any questions, please contact the Customer Support Team for assistance. |
| 86 | Game is restricted | Please refer to the Game List document or inquire with the 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: The FEATURE GAME Card sent by this API takes effect immediately.
Frequently Asked Questions
Q1: How to obtain the itemBet List in the sending parameters?
A: Through Get Operator Card Information, you can query the complete supported list. You can also input any value, and our system will automatically select the closest and lower bet from the Games' betList for sending.
Q2: Does the FEATURE GAME sent by this API have an expiration time?
A: After sending, if the Player has not logged in to use the Games, it will be automatically settled 12 hours after sending.
Q3: Can the FEATURE GAME sent by this API be cancelled?
A: Yes, it can. It can be cancelled via the Cancel Operator Card API, but this must be done before the Player enters the Games to use it or before automatic settlement. Otherwise, it cannot be cancelled.
Q4: Will the Player be informed after automatic settlement?
A: When the Player logs into the Games, a reward notification message will be displayed, but the performance animation will not be re-displayed.