Action 71：查询玩家的免费场次资讯
功能说明
- 查询玩家的免费场次资讯
- 免费场次资讯保留至场次过期后 180 天内
参数
| 参数 | 格式 | 强制 | 说明 |
|---|---|---|---|
| action | Integer | Y | 71 |
| ts | Long | Y | 当前系统时间 |
| parent | String(50) | Y | 代理账号 |
| uid | String(50) | Y | 玩家账号 |
| startTime | String | N | 免费场次开始时间查询区段起始时间（ISO-8601 中以下格式） yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm |
| endTime | String | N | 免费场次开始时间查询区段结束时间（ISO-8601 中以下格式） yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm |
| status | Integer | N | 免费场次状态 未启用：0 启用：1 过期：2 终止：3 |
Example
{
"action": 71,
"ts": 1704790101741,
"parent": "testag",
"uid": "testplayer",
"startTime": "2024-07-22T04:05:33.000+01:00",
"endTime": "2024-07-23T04:05:33.000+01:00",
"status": 1
}返回结果
| 参数 | 格式 | 说明 |
|---|---|---|
| status | String(4) | 成功：0000 错误：参照附录 错误代码 |
| data | JSON Array | 回传的数据组将列于下表中 |
| err_text | String(255) | 错误讯息 |
免费场次游戏详细内容
| 参数 | 格式 | 说明 |
|---|---|---|
| eventId | Long | 免费场次识别代号 |
| name | String | 免费场次名称 |
| currency | String(10) | 货币别 参照附录 货币代码 |
| times | Long | 免费场次可使用次数 |
| useTimes | Long | 玩家已使用次数 |
| startTime | String | 免费场次开始时间（ISO-8601 中以下格式） yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm |
| endTime | String | 免费场次结束时间（ISO-8601 中以下格式） yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm |
| type | String | 免费场次类别NORMAL: 免费场次赠送一般游戏FEATURE: 免费场次赠送 Feature Buy |
| status | String | 免费场次状态 INACTIVE: 未启用 ACTIVE: 启用 EXPIRED: 过期 TERMINATED: 终止 |
| machineTypes | Integer Array | 机台类型 参照附录 游戏列表 （4.2） |
| cashout | String | 玩家提取金额 |
| updateTime | String | 更新时间（ISO-8601 中以下格式） yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm |
操作范例
// 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. 若查询玩家非代理下线，我方会回传：
{
"status": "7501",
"err_text": "User ID cannot be found."
}
2. 若查询区段起始时间大于查询区段结束时间，我方会回传：
{
"status": "8009",
"err_text": "Time interval exceeds the allowable range."
}