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 GameFEATURE: 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."
}