Action 72：创建免费场次

功能说明

免费场次创建后不能更改免费场次类型、免费场次次数、红利筹码、筹码倍数、免费场次开始时间、免费场次结束时间、开奖类型
最小可提现金额必须小于或等于最大可提现金额。
结束时间必须晚于当前时间。
如果传递了 players 字段，则在创建后将同时绑定玩家。
- 为了防止 API 执行时间过长，每次调用最多可处理 50,000 个玩家账号，可使用 Action 74 继续绑定。
如果传递了 eventId 字段则以指定 eventId 创建，规则为1～50 字符的英数字或底线(_)。若未带入，则由系统自行产生。
若返回 eventId，表示免费场次创建成功。
玩家绑定成功与否不影响免费场次的创建。
关于 免费场次单场投注额：
- 由于各支线、代理和游戏的投注组合不同，系统默认选择匹配投注额(最接近且不超过设定值的投注额)。
  - 示例:
    游戏 A 的投注组合设定为1、5、15、20、30
    游戏 B 的投注组合设定为1、5、20、25、30
    当 一般游戏、特色游戏的bet 设定为 25 时，玩家进入游戏后会看到：
    游戏 A 的匹配投注额为 20。
    游戏 B 的匹配投注额为 25。
    因此，bet 必须大于所有指定游戏的最小投注金额。
- 若创建 特色游戏，会检查 匹配投注额 × 特色游戏倍数 不超过 特色游戏投注上限。
  (可使用 Action 49：查询游戏列表查询特色游戏倍数、特色游戏投注上限)
  - 示例：
    游戏 A 的投注组合：1、5、15、20、30
    游戏 B 的投注组合：1、5、20、25、30
    游戏 A 的特色游戏倍数 = 50，游戏 B 的特色游戏倍数 = 100
    游戏 A 、 B 的 特色游戏投注上限 = 2000
    当 特色游戏 bet 设定为 25 创建特色游戏时：
    游戏 A 的匹配投注额为 20。
    游戏 B 的匹配投注额为 25。
    游戏 A 的 匹配投注额 × 特色游戏倍数 = 20 × 50 = 1000
    游戏 B 的 匹配投注额 × 特色游戏倍数 = 25 × 100 = 2500
    因为游戏 B 匹配投注额 × 特色游戏倍数 大于 特色游戏投注上限(2500 > 2000)，导致游戏 A 、 B 将无法创建。
关于红利筹码的免费场次游戏
- 需提供红利筹码和筹码倍数两个参数，系统会将红利筹码和筹码倍数相乘后计算出筹码流水要求
- 玩家可以使用红利筹码下注，并且每次下注都会累积流水，若玩家累积流水达到筹码流水要求则可以提领剩余的红利筹码
- 范例:
  - 红利筹码设定为 100、筹码倍数设定为 2.5，则筹码流水要求为 250。当玩家累积流水达到 250 时，且红利筹码剩余 30，则可提领金额为 30

参数

参数	格式	强制	说明
action	Integer	Y	72
ts	Long	Y	当前系统时间
parent	String(50)	Y	代理账号
eventId	String(50)	N	免费场次识别代号
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）
type	String	Y	免费场次类别 `NORMAL: 免费场次赠送一般游戏` `FEATURE: 免费场次赠送 Feature Buy` `BONUSCHIPS: 红利筹码游戏`
minWithdrawal	String	Y	最小可提领金额 `可填写 -1 表示不做限制，即没有最小提领金额的限制。`
maxWithdrawal	String	Y	最大可提领金额 `可填写 -1 表示不做限制，即没有最大提领金额的限制。`
transactionId	String(36)	Y	请求标识码 `为确保若请求虽未成功取得回传 eventId 但创建免费场次已成功，若带入相同请求标识码则不再创建免费场次且回传已创建之免费场次的 eventId，反之若带入之请求标识码尚未有已成功创建之免费场次则以此请求标识码创建免费场次并回传 eventId`
players	String Array	N	玩家账号数组（最多支持 50,000 个，可选字段；若传入，则在创建场次后自动绑定对应玩家）
mysteryType	String	N	开奖类型 NONE: 無（默认） BLINDBOX: 盲盒开发中

當 type 為 NORMAL 時

参数	格式	强制	说明
bet	String	Y	免费场次单场投注额 `系统默认选择匹配投注额(最接近且不超过设定值的投注额)`
times	String	Y	免费场次次数

當 type 為 FEATURE 時

参数	格式	强制	说明
bet	String	Y	免费场次单场投注额 `系统默认选择匹配投注额(最接近且不超过设定值的投注额)` `匹配投注额 × 特色游戏倍数，不超过该特色游戏投注上限。`
times	String	Y	免费场次次数

當 type 為 BONUS 時

参数	格式	强制	说明
bonusChips	String	Y	红利筹码
chipsMultiplier	String	Y	筹码倍数

Example

{
  "action": 72,
  "ts": 1711555200000,
  "parent": "testag",
  "eventId": "event_001",
  "name": "TEST NORMAL 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",
  "transactionId": "testtransactionId00001",
  "players": [
      "player1",
      "player2"
  ],
  "mysteryType": "NONE"
}

{
  "action": 72,
  "ts": 1711555200000,
  "parent": "testag",
  "eventId": "event_001",
  "name": "TEST BONUS CHIPS EVENT NAME",
  "startTime": "2024-07-22T04:05:33.000+01:00",
  "endTime": "2024-07-22T04:05:33.000+01:00",
  "machineTypes": [
      14041,
      14087
  ],
  "bonusChips": "100.000",
  "chipsMultiplier": "2.50",
  "type": "BONUSCHIPS",
  "minWithdrawal": "10.000",
  "maxWithdrawal": "100.000",
  "transactionId": "testtransactionId00001",
  "players": [
      "player1",
      "player2"
  ],
  "mysteryType": "NONE"
}

返回结果

参数	格式	说明
status	String(4)	成功：0000 错误：参照附录错误代码
data	JSON Object	`回传的数据将列于下列表中`
err_text	String(255)	错误讯息

Data 对象

参数	格式	说明
eventId	String(50)	免费场次识别代号
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": "event_001",
        "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"
}

Action 71：查询玩家的免费场次资讯 Action 73：终止免费场次