Seamless
JDB Platform API
Functions
Free Spin Reward
Action 77: Update Free Spin Reward Event

Action 77:Update Free Spin Reward Event

Function Description

  • Update Free Spin Reward Event
  • Minimum Withdrawal must be less than or equal to Maximum Withdrawal
  • If status is 0000, it indicates successful update of Free Spin Reward Event
  • Free Spin Reward Event do not support modifying type, times, bonusChips, chipsMultiplier, startTime and endTime. If adjustments are needed, please use action 73 to terminate the event first and then recreate it.
  • About Free Spin Reward Single Bet Amount :
    • Since the bet options of each currency houses, agents, and games are different, the system will automatically select Matched Bet Amount(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 Matched Bet Amount in Game A will be 20.
      The Matched Bet Amount in Game B will be 25.
      Therefore, bet must be greater than the minimum bet amount for all specified games.
    • When creating a Feature Game, the system will check whether
      Matched Bet Amount × Feature Game Multiplier does not exceed the Maximum Feature Game Bet Limit.

      (You can use the query service provided by Action 49: Query Game List to retrieve the Feature Game Multiplier and the Maximum Feature Game Bet Limit.)
      • Example:
        Game A bet options: 1, 5, 15, 20, 30
        Game B bet options: 1, 5, 20, 25, 30
        Game A feature multiplier = 50, Game B feature multiplier = 100
        Maximum Feature Game Bet limit for both Game A and Game B = 2000
        When Feature Game bet is set to 25 to create a Feature Game:
        Game A Matched Bet Amount is 20.
        Game B Matched Bet Amount is 25.
        Game A Matched Bet Amount × Feature Multiplier = 20 × 50 = 1000
        Game B Matched Bet Amount × Feature Multiplier = 25 × 100 = 2500
        Since Game B’s Matched Bet Amount × Feature Multiplier exceeds the Maximum Feature Game Bet Limit (2500 > 2000),
        neither Game A nor Game B can be created.

Parameter

ParameterFormatMandatoryDescription
actionInteger.Y77
tsLongYCurrent system time
parentString(50)YAgent ID
eventIdString(50)YFree Spin Reward Event ID
nameString(70)YFree Spin Reward Event Name
machineTypesInteger ArrayYMachine Type

See Game List (4.2) in appendix
betStringNFree Spin Reward Bet Amount per Spin
Normal or Featured game must provide this field
The system auto-sets the bet, not exceeding the specified amount for each game spin.
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.

Example

{
  "action": 77,
  "ts": 1711555200000,
  "parent": "testag",
  "eventId": "1234",
  "name": "TEST EVENT NAME",
  "machineTypes": [
      14077,
      14085
  ],
  "bet": "2.000",
  "minWithdrawal": "10.000",
  "maxWithdrawal": "100.000"
}

Return Results

ParameterFormatDescription
statusString(4)Success: 0000

Error: See Error Codes in Appendix
err_textString(255)Error message

Operation Sample

// Http Request
http://{API_Address}/apiRequest.do?dc=jb1&x=y1wayxScczy6ABfElfaVwb5CdfHxBN_JGtxyBSvpohLQakP8M2QSetJNojJBzvnrVChhq8YWWgBTdGeXFTH4vSNQQ66epf4NqYeQ-6bJ15pvHctQjQevulv7GHqOifuju_gY0H54FfVdQc9D5tKh1AZ-9KDh9dwcGSszZxU7JOOoHdYITlCO5LhvGmHxPBwZ
 
// Http Response (success)
{
    "status": "0000"
}
 
// 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"
}
 
2. If free spin reward event not exist, then:
{
    "status": "9998",
    "err_text": "Event not exist."
}
 
3. If free spin reward event status not allow to do this action, then:
{
    "status": "9998",
    "err_text": "This action cannot be executed as the event status is INACTIVE."
}