Action 70: Search for Free Spin Reward History
Function Description
- Search for a single parent ID’s details of free spin reward history with a given time range, distinguished by game type with gType.
- Supports range: SLOT(0)
- The values of ss.sss(seconds.milliseconds) in start time and end time must be 00.000.
- The maximum time range for each search is 5 minutes.
- To obtain better response when huge data and heavy traffic, specifying a time range less than 1 minute for each search is recommended.
- The function searches for the data according to the game date of the game record.
- Provides records of free spin reward from 3 minutes ago to within 180 days. For example, if querying for five minutes at 15:00:00, then the data range would be the information from 14:52:00.000 to 14:57:00.000.
Parameter
| Parameter | Format | Mandatory | Description |
|---|---|---|---|
| action | Integer | Y | 70 |
| ts | Long | Y | Current system time |
| parent | String(50) | Y | Agent ID |
| startTime | String | Y | Start time of the searching range (Only conforming to the following format in ISO-8601) yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm |
| endTime | String | Y | End time of the searching range (Only conforming to the following format in ISO-8601) yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm |
| gTypes | Integer Array | Y | Game types Supports range: SLOT(0) |
| uid | String(50) | N | PlayerID |
Example
{
"action": 70,
"ts": 1710154494058,
"parent": "testag",
"startTime": "2024-07-22T04:05:00.000+01:00",
"endTime": "2024-07-22T04:05:00.000+01:00",
"gTypes": [0],
"uid":"testpl" // Optional
}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 |
|---|---|---|
| historyId | String(100) | Game History ID See Explanation of historyId. The system is scheduled to update the field to String(200) in the test environment on Aug 21, 2025, and will be gradually rolled out to the production environment on Aug 26, 2025 |
| uid | String(50) | Player ID |
| gType | String | Game Types See Game Provider |
| mtype | String | Machine Type See Game List (4.2) |
| gameDate | String | Date of Playing (Only conforming to the following format in ISO-8601) yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm |
| denom | String | Bet Denomination |
| bet | String | Bet Amount |
| win | String | Winning points in the game |
| currency | String(10) | Currency Types See Currency Code |
| lastModifyTime | String | Last Modified Time (Only conforming to the following format in ISO-8601) yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm |
| eventId | String | Free Spin Reward ID |
| eventName | String | Free Spin Reward Name |
| eventBet | String | Free Spin Reward Bet If this record pertains to a "Bonus Chips" game, this field will return null |
Operation Sample
// Http Request
http://{API_Address}/apiRequest.do?dc=xb&x=4x30pdhFGt07YgN1yJSAdb_Cma3VNC3FDgJZZIgZWUd-BOHHX7Bz-zMpNOm08tFOon2DMmxRZOBUy_elSkh1anVTug3fJAozNDM4B1kRqdC_4qwPrwWhFzlCkp3AM2W2QV5Vrfv2USKoPsOCECxp6tamrMJmpvZcE5s0Ry7aUzAFCkJAqMC8WxCHhXiCmQx0wKjfysoXR_v1yJAEl54H-g
// Http Response (success)
{
"status": "0000",
"data": [
{
"historyId": "5250229021202",
"uid": "testpl01@XB",
"gameDate": "2024-07-17T16:00:00.000+01:00",
"bet": "10.0000",
"win": "0.0000",
"currency": "RB",
"lastModifyTime": "2024-07-17T16:00:00.000+01:00",
"eventId": "12686",
"eventName": "test event",
"eventBet": "10.0000",
"gType": "0",
"mtype": "14085",
"denom": "500"
},
{
"historyId": "5250229021203",
"uid": "testpl01",
"gameDate": "2024-07-17T17:00:00.000+01:00",
"bet": "10.0000",
"win": "0.0000",
"currency": "RB",
"lastModifyTime": "2024-07-17T16:00:00.000+01:00",
"eventId": "12687",
"eventName": "test bonus chips event",
"eventBet": null,
"gType": "0",
"mtype": "14087",
"denom": "500"
}
]
}
// Http Response (failed)
1. If necessary parameters are not provided, for example: gTypes, then:
{
"status": "8000",
"err_text": "The parameter of input error, please check your parameter is correct or not. parameter:gTypes is required"
}
// Http Response (no data)
{
"status": "0000",
"data": []
}