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 |
| 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 |
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"
}
]
}
// 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": []
}