Seamless
JDB Platform API
Functions
Free Spin Reward
Action 72: Create Free Spin Reward Event

Action 72:Create Free Spin Reward Event

Function Description

  • Once a free spin reward event is created, both times and type 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 are 1, 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.

Parameter

ParameterFormatMandatoryDescription
actionIntegerY72
tsLongYCurrent system time
parentString(50)YAgent ID
nameString(70)YFree Spin Reward Name
startTimeStringYFree Spin Reward Evnet Start Time (Only conforming to the following format in ISO-8601)
yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm
endTimeStringYFree Spin Reward Evnet End Time (Only conforming to the following format in ISO-8601)
yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm
machineTypesInteger ArrayYMachine Type
See Game List (4.2) in appendix
betStringYFree Spin Reward Bet Amount per Spin
The system auto-sets the bet, not exceeding the specified amount for each game spin.
timesIntegerYFree Spin Reward Times
typeStringYFree Spin Reward Type
NORMAL: Free spin for Base Game
FEATURE: Free spin for Feature Buy
minWithdrawalStringYMinimum Withdrawal Amount
Can be set to -1 to indicate no limit, i.e. no minimum withdrawal amount restriction.
maxWithdrawalStringYMaximum Withdrawal Amount
Can be set to -1 to indicate no limit, i.e. no maximum withdrawal amount restriction.
transactionIdString(36)YRequest Identifier
To 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
playersString ArrayNPlayer 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

ParameterFormatDescription
statusString(4)Success: 0000

Error: See Error Codes in Appendix
No Data: 0000
dataJSON ObjectThe failed bind player ID returned data will be listed in the following table.
err_textString(255)Error message

Data Object

ParameterFormatDescription
eventIdLongFree Spin Reward Event ID
failedBindingPlayersArray of StringThe failed bind player ID list
notExistedPlayersArray of StringThe 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"
}