Transfer
JDB 平台 API
免费场次相关
Action 72：创建免费场次

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

参数


参数格式强制说明
actionIntegerY72
tsLongY当前系统时间
parentString(50)Y代理账号
eventIdString(50)N免费场次识别代号
nameString(70)Y免费场次名称
startTimeStringY免费场次开始时间（ISO-8601 中以下格式）
yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm
endTimeStringY免费场次结束时间（ISO-8601 中以下格式）
yyyy-MM-ddTHH:mm:ss.sss+|-hh:mm
machineTypesInteger ArrayY机台类型
参照附录 游戏列表 （4.2）
typeStringY免费场次类别
NORMAL: 免费场次赠送一般游戏
FEATURE: 免费场次赠送 Feature Buy
BONUSCHIPS: 红利筹码游戏
minWithdrawalStringY最小可提领金额
可填写 -1 表示不做限制，即没有最小提领金额的限制。
maxWithdrawalStringY最大可提领金额
可填写 -1 表示不做限制，即没有最大提领金额的限制。
transactionIdString(36)Y请求标识码
为确保若请求虽未成功取得回传 eventId 但创建免费场次已成功，若带入相同请求标识码则不再创建免费场次且回传已创建之免费场次的 eventId，反之若带入之请求标识码尚未有已成功创建之免费场次则以此请求标识码创建免费场次并回传 eventId
playersString ArrayN玩家账号数组（最多支持 50,000 个，可选字段；若传入，则在创建场次后自动绑定对应玩家）
mysteryTypeStringN开奖类型
NONE: 無（默认）
BLINDBOX: 盲盒 开发中

當 type 為 NORMAL 時

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

當 type 為 FEATURE 時

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

當 type 為 BONUS 時

参数格式强制说明
bonusChipsStringY红利筹码
chipsMultiplierStringY筹码倍数

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"
}

返回结果

参数格式说明
statusString(4)成功：0000

错误：参照附录 错误代码
dataJSON Object回传的数据将列于下列表中
err_textString(255)错误讯息

Data 对象

参数格式说明
eventIdString(50)免费场次识别代号
failedBindingPlayersArray of String绑定失败玩家列表
notExistedPlayersArray 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：终止免费场次