Action 72：创建免费场次
功能说明
- 请务必注意，必须实现 免费场次派彩（Action 16），方可正常进行派奖。
- 免费场次创建后，
times和type均不可更改。 - 最小可提现金额必须小于或等于最大可提现金额。
- 结束时间必须晚于当前时间。
- 如果传递了
players字段，则在创建后将同时绑定玩家。- 为了防止 API 执行时间过长，每次调用最多可处理 50,000 个玩家账号，可使用 Action 74 继续绑定。
- 若返回
eventId，表示免费场次创建成功。 - 玩家绑定成功与否不影响免费场次的创建。
- 关于
bet：由于各支线、代理和游戏的投注组合不同，系统默认选择最接近且不超过设定值的投注额。- 示例:
- 游戏 A 的投注组合设定为
1、5、15、20、30，游戏 B 的投注组合设定为1、5、20、25、30。 - 当
bet设定为 25 时，玩家进入游戏后会看到：- 游戏 A 的投注额将锁定为
20。 - 游戏 B 的投注额将锁定为
25。
- 游戏 A 的投注额将锁定为
- 因此，
bet必须大于所有指定游戏的最小投注金额。
- 游戏 A 的投注组合设定为
- 示例:
参数
| 参数 | 格式 | 强制 | 说明 |
|---|---|---|---|
| action | Integer | Y | 72 |
| ts | Long | Y | 当前系统时间 |
| parent | String(50) | Y | 代理账号 |
| name | String(70) | Y | 免费场次名称 |
| startTime | String | Y | 免费场次开始时间（ISO-8601 中以下格式） yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm |
| endTime | String | Y | 免费场次结束时间（ISO-8601 中以下格式） yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm |
| machineTypes | Integer Array | Y | 机台类型 参照附录 游戏列表 （4.2） |
| bet | String | Y | 免费场次单场押注金额系统将自动设定投注额，以不超过指定的额度供玩家进行游戏。 |
| times | Integer | Y | 免费场次次数 |
| type | String | Y | 免费场次类别NORMAL: 免费场次赠送一般游戏FEATURE: 免费场次赠送 Feature Buy |
| minWithdrawal | String | Y | 最小可提领金额可填写 -1 表示不做限制，即没有最小提领金额的限制。 |
| maxWithdrawal | String | Y | 最大可提领金额可填写 -1 表示不做限制，即没有最大提领金额的限制。 |
| transactionId | String(36) | Y | 请求标识码为确保若请求虽未成功取得回传 eventId 但创建免费场次已成功，若带入相同请求标识码则不再创建免费场次且回传已创建之免费场次的 eventId，反之若带入之请求标识码尚未有已成功创建之免费场次则以此请求标识码创建免费场次并回传 eventId |
| players | String Array | N | 玩家账号数组（最多支持 50,000 个，可选字段；若传入，则在创建场次后自动绑定对应玩家） |
| autoCreatePlayerEnabled | Boolean | N | 自动创建玩家帐号 true：开启。启用该功能后， players 数组字段的数量限制为 1，系统将为该玩家自动创建账号false：关闭（默认值） |
Example
{
"action": 72,
"ts": 1711555200000,
"parent": "testag",
"name": "TEST EVENT NAME",
"startTime": "2024-07-22T04:05:33.000+01:00",
"endTime": "2024-07-22T04:05:33.000+01:00",
"machineTypes": [
14077,
14085
],
"bet": "2.000",
"times": 10,
"type": "NORMAL",
"minWithdrawal": "10.000",
"maxWithdrawal": "100.000",
"players": [
"player1",
"player2"
]
}返回结果
| 参数 | 格式 | 说明 |
|---|---|---|
| status | String(4) | 成功：0000 错误：参照附录 错误代码 |
| data | JSON Object | 回传的数据将列于下列表中 |
| err_text | String(255) | 错误讯息 |
Data 对象
| 参数 | 格式 | 说明 |
|---|---|---|
| eventId | Long | 免费场次识别代号 |
| failedBindingPlayers | Array of String | 绑定失败玩家列表 |
| notExistedPlayers | Array of String | 不存在的玩家列表 |
操作范例
// Http Request
http://{API_Address}/apiRequest.do?dc=jb1&x=y1wayxScczy6ABfElfaVwb5CdfHxBN_JGtxyBSvpohLQakP8M2QSetJNojJBzvnrVChhq8YWWgBTdGeXFTH4vSNQQ66epf4NqYeQ-6bJ15pvHctQjQevulv7GHqOifuju_gY0H54FfVdQc9D5tKh1AZ-9KDh9dwcGSszZxU7JOOoHdYITlCO5LhvGmHxPBwZ
// Http Response (success)
{
"status": "0000",
"data": {
"eventId": 12345,
"failedBindingPlayers": [
"failed1", "failed2"
],
"notExistedPlayers": [
"not_exist1", "not_exist2",
]
}
}
// Http Response (failed)
1. 若输入参数有误，我方会回传：
{
"status": "8000",
"err_text": "The parameter of input error, please check your parameter is correct or not. parameter:name is required"
}