Seamless
JDB Platform API
Functions
Free Spin Reward
Action 71: Search Free Spin Reward event info of a specified player

Action 71:Search Free Spin Reward event info of a specified player

Function Description

  • Search Free Spin Reward event info of a specified player.
  • Free Spin Reward information is retained for 180 days after the free spin reward expires.

Parameter

ParameterFormatMandatoryDescription
actionIntegerY71
tsLongYCurrent system time
parentString(50)YAgent ID
uidString(50)YPlayerID
startTimeStringNStart time of the searching range for the event start time (Only conforming to the following format in ISO-8601)
yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm
endTimeStringNEnd time of the searching range for the event start time (Only conforming to the following format in ISO-8601)
yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm
statusIntegerNFree Spin Reward Evnet Status
INACTIVE:0
ACTIVE:1
EXPIRED:2
TERMINATED:3

Example

{
  "action": 71,
  "ts": 1704790101741,
  "parent": "testag",
  "uid": "testplayer",
  "startTime": "2024-07-22T04:05:33+01:00",
  "endTime": "2024-07-23T04:05:33+01:00",
  "status": 1
}

Return Results

ParameterFormatDescription
statusString(4)Success: 0000

Error: See Error Codes in Appendix
No Data: 0000
dataJSON ArrayThe returned listed in the following table.
err_textString(255)Error message

Free Spin Reward Detail

ParameterFormatDescription
eventIdLongFree Spin Reward ID
nameStringFree Spin Reward Name
currencyString(10)Currency Types

See Currency Code
timesLongFree Spin Reward Available Times
useTimesLongPlayer Used Times
startTimeStringFree Spin Reward Start Time (Only conforming to the following format in ISO-8601)
yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm
endTimeStringFree Spin Reward End Time (Only conforming to the following format in ISO-8601)
yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm
typeStringFree Spin Reward Type
NORMAL: Free spin for Base Game
FEATURE: Free spin for Feature Buy
statusStringFree Spin Reward Status
INACTIVE: Inactive
ACTIVE: Active
EXPIRED: Expired
TERMINATED: Terminated
machineTypesInteger ArrayMachine Types

See Game List (4.2) in appendix
cashoutStringPlayer Cashout Amount
updateTimeStringUpdate Time (Only conforming to the following format in ISO-8601)
yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm

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,
            "name": "test event name",
            "currency": "RB",
            "times": 3,
            "useTimes": 3,
            "startTime": "2024-07-17T16:00:00.000+01:00",
            "endTime": "2024-07-22T16:00:00.000+01:00",
            "type": "NORMAL",
            "status": "EXPIRED",
            "machineTypes": [
              14050,
              14053
            ],
            "cashout": "1.000",
            "updateTime": "2024-07-22T16:00:00.000+01:00"
        }
    ]
}
 
// Http Response (failed)
1. If query player not downline of agent, will receive response:
{
    "status": "7501",
    "err_text": "User ID cannot be found."
}
 
2. If query startime is greater than endtime, will receive response:
{
    "status": "8009",
    "err_text": "Time interval exceeds the allowable range."
}