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
Parameter | Format | Mandatory | Description |
---|---|---|---|
action | Integer | Y | 71 |
ts | Long | Y | Current system time |
parent | String(50) | Y | Agent ID |
uid | String(50) | Y | PlayerID |
startTime | String | N | Start 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 |
endTime | String | N | End 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 |
status | Integer | N | Free 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
Parameter | Format | Description |
---|---|---|
status | String(4) | Success: 0000 Error: See Error Codes in Appendix No Data: 0000 |
data | JSON Array | The returned listed in the following table. |
err_text | String(255) | Error message |
Free Spin Reward Detail
Parameter | Format | Description |
---|---|---|
eventId | Long | Free Spin Reward ID |
name | String | Free Spin Reward Name |
currency | String(10) | Currency Types See Currency Code |
times | Long | Free Spin Reward Available Times |
useTimes | Long | Player Used Times |
startTime | String | Free Spin Reward Start Time (Only conforming to the following format in ISO-8601) yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm |
endTime | String | Free Spin Reward End Time (Only conforming to the following format in ISO-8601) yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm |
type | String | Free Spin Reward TypeNORMAL: Free spin for Base Game FEATURE: Free spin for Feature Buy |
status | String | Free Spin Reward Status INACTIVE: Inactive ACTIVE: Active EXPIRED: Expired TERMINATED: Terminated |
machineTypes | Integer Array | Machine Types See Game List (4.2) in appendix |
cashout | String | Player Cashout Amount |
updateTime | String | Update 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."
}