Action 72:Create Free Spin Reward Event
Function Description
- Please make sure to implement Free Spin Reward (Action 16) in order for the prize distribution to function properly.
- Once a free spin reward event is created, both
times
andtype
cannot be modified. - The minimum withdrawal must be less than or equal to the maximum withdrawal.
- The end time must be later than the current time.
- If the
players
field is provided, players will be bound upon creation.- To avoid long API execution times, each call is limited to 50,000 player accounts. Use Action 74 to add more.
- If eventId is returned, it indicates successful creation of free spin reward event
- Whether player binding succeeds or not does not affect the creation of the free spin reward event
- About
bet
: Since the bet options of each currency houses, agents, and games are different, the system will automatically select the closest bet amount that does not exceed the specified value.- For instance, the bet options for Game A are
1, 5, 15, 20, 30
, while the bet options for Game B are1, 5, 20, 25, 30
. bet
is set as 25, when the player joins one of the games, the bet amount will vary as the following:- The bet amount in Game A will be locked at 20.
- The bet amount in Game B will be locked at 25.
- Therefore,
bet
must be greater than the minimum bet amount for all specified games.
- For instance, the bet options for Game A are
Parameter
Parameter | Format | Mandatory | Description |
---|---|---|---|
action | Integer | Y | 72 |
ts | Long | Y | Current system time |
parent | String(50) | Y | Agent ID |
name | String(70) | Y | Free Spin Reward Name |
startTime | String | Y | Free Spin Reward Evnet Start Time (Only conforming to the following format in ISO-8601) yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm |
endTime | String | Y | Free Spin Reward Evnet End Time (Only conforming to the following format in ISO-8601) yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm |
machineTypes | Integer Array | Y | Machine Type See Game List (4.2) in appendix |
bet | String | Y | Free Spin Reward Bet Amount per SpinThe system auto-sets the bet, not exceeding the specified amount for each game spin. |
times | Integer | Y | Free Spin Reward Times |
type | String | Y | Free Spin Reward TypeNORMAL: Free spin for Base Game FEATURE: Free spin for Feature Buy |
minWithdrawal | String | Y | Minimum Withdrawal AmountCan be set to -1 to indicate no limit, i.e. no minimum withdrawal amount restriction. |
maxWithdrawal | String | Y | Maximum Withdrawal AmountCan be set to -1 to indicate no limit, i.e. no maximum withdrawal amount restriction. |
transactionId | String(36) | Y | Request IdentifierTo ensure that even if the request did not successfully return the eventId, but the creation was successful, if the same request identifier is brought in, it will no longer create event again and return the eventId of the already created event. On the contrary, if the request identifier brought in has not yet successfully created, then create with this request identifier and return the eventId |
players | String Array | N | Player ID List (Optional fields, maximum of 50,000 entries per request.) |
Example
{
"action": 72,
"ts": 1711555200000,
"parent": "testag",
"name": "TEST EVENT NAME",
"startTime": "2024-07-22T04:05:33.000+01:00",
"endTime": "2024-07-22T04:05:33.000+01:00",
"machineTypes": [
14077,
14085
],
"bet": "2.000",
"times": 10,
"type": "NORMAL",
"minWithdrawal": "10.000",
"maxWithdrawal": "100.000",
"players": [
"player1",
"player2"
]
}
Return Results
Parameter | Format | Description |
---|---|---|
status | String(4) | Success: 0000 Error: See Error Codes in Appendix No Data: 0000 |
data | JSON Object | The failed bind player ID returned data will be listed in the following table. |
err_text | String(255) | Error message |
Data Object
Parameter | Format | Description |
---|---|---|
eventId | Long | Free Spin Reward Event ID |
failedBindingPlayers | Array of String | The failed bind player ID list |
notExistedPlayers | Array of String | The non-existent player ID list |
Operation Sample
// Http Request
http://{API_Address}/apiRequest.do?dc=jb1&x=y1wayxScczy6ABfElfaVwb5CdfHxBN_JGtxyBSvpohLQakP8M2QSetJNojJBzvnrVChhq8YWWgBTdGeXFTH4vSNQQ66epf4NqYeQ-6bJ15pvHctQjQevulv7GHqOifuju_gY0H54FfVdQc9D5tKh1AZ-9KDh9dwcGSszZxU7JOOoHdYITlCO5LhvGmHxPBwZ
// Http Response (success)
{
"status": "0000",
"data": {
"eventId": 12345,
"failedBindingPlayers": [
"failed1", "failed2"
],
"notExistedPlayers": [
"not_exist1", "not_exist2",
]
}
}
// Http Response (failed)
1. If necessary parameters are not provided or not meet requirement, for example: name, then:
{
"status": "8000",
"err_text": "The parameter of input error, please check your parameter is correct or not. parameter:name is required"
}