1.优化下注接口/api/game/betPlace

2.优化后台/admin/config/gameConfig中新增压注筹码配置
This commit is contained in:
2026-05-14 10:37:21 +08:00
parent c7fc754573
commit 932a433613
10 changed files with 392 additions and 41 deletions

View File

@@ -231,8 +231,10 @@
- `open_at`int含义预计开奖时间戳
- `bet_config`object
- `pick_max_number_count`int含义单注最多可选号码数来自 `game_config.config_key = pick_max_number_count`,缺省与库内种子一致,通常为 10合法范围 136
- `chips`array[string](如 `["1.00","5.00"]`,含义:快捷筹码面额
- `single_number_max_bet`string(含义:单号码最大下注额
- `chips`object含义快捷筹码字典固定 6 个键 `"1"``"6"`,值为该档单注面额字符串,两位小数;与后台 `game_config.bet_chips` 语义一致
- `default_bet_chip_id`int(含义:默认选中的筹码标识,来自 `game_config.default_bet_chip_id`,非法或指向无效档位时服务端回退为首个有效档
- `min_bet_per_number`string含义单号码最小下注额须 ≤ 所选筹码面额且受后台配置约束)
- `max_bet_per_number`string含义单号码最大下注额
- `dictionary`array<object>
- `number`int1-36含义字花编号
- `name`string含义字花名称
@@ -263,20 +265,20 @@
### 4.2 提交下注
- **POST** `/api/game/placeBet`(兼容旧路径 `/api/game/betPlace`
- 用途:单期手动下注;玩家传入**压注号码**与**单注金额 `single_bet_amount`**。服务端按 `single_bet_amount × numbers数量` 计算本笔总扣款(落库 `total_amount`),开奖只出一个号码,若该号码 ∈ 所选号码集合即视为中奖。
- 用途:单期手动下注;玩家传入**压注号码**与**筹码标识 `bet_id`16**。单注金额由后台 `game_config.bet_chips` 解析,服务端按 `单注金额 × numbers数量` 计算本笔总扣款(落库 `total_amount`),开奖只出一个号码,若该号码 ∈ 所选号码集合即视为中奖。
请求参数:
- `period_no`string含义下注目标期号
- `numbers`string含义本次压注号码集合**英文逗号分隔**,如 `1,8,16`;每个号码为 136 的整数,数量不超过 `pick_max_number_count`(同 `lobbyInit.bet_config`),重复号码会去重)
- `single_bet_amount`string含义**单注金额**> 0
- `bet_amount`string兼容字段含义同 `single_bet_amount`
- `bet_id`int含义**快捷筹码标识**,取值 16须为 `lobbyInit.bet_config.chips` 中存在的键;不再使用 `single_bet_amount` / `bet_amount` 传参
- `idempotency_key`string必填含义防止重复下单
返回参数:
- `order_no`string含义下注订单号
- `period_no`string含义实际落单期号
- `status`string`accepted`/`rejected`,含义:受理结果)
- `single_bet_amount`string(含义:本次单注金额
- `bet_id`int(含义:本次使用的筹码标识
- `single_bet_amount`string含义本次单注金额`bet_id` 对应档位解析得到)
- `numbers_count`int含义本次号码数量
- `locked_balance`string可选含义冻结金额
- `balance_after`string含义下单后余额
@@ -294,12 +296,14 @@
- `action`string`start`/`stop`
- `period_no`string`action=start` 时必填)
- `numbers`string`action=start` 时必填,英文逗号分隔)
- `single_bet_amount`string`action=start` 时必填,支持兼容字段 `bet_amount`
- `bet_id`int`action=start` 时必填,含义同 `placeBet`,快捷筹码 16
- `rounds`int`action=start` 时必填,>=1
返回参数:
- `status`string`scheduled`/`stopped`
- `auto_mode`bool
- `bet_id`int`start` 返回,本次托管使用的筹码标识)
- `single_bet_amount`string`start` 返回,由 `bet_id` 解析得到的单注面额)
- `remaining_rounds`int`start` 返回)
### 4.4 查询我的下注记录最近1个月
@@ -715,7 +719,7 @@
- **客户端**:浏览器原生 `WebSocket``ws://` / `wss://`
- **连接时携带参数(建议)**
- URL Query`token`(用户登录态 user-token`auth_token`(接口鉴权)、`device_id`(设备标识)、`lang``zh/en`
- 示例:`wss://ws.example.com/game?token=xxx&auth_token=xxx&device_id=ios_001&lang=zh`
- 示例:`wss://ws.example.com/ws?token=xxx&auth_token=xxx&device_id=ios_001&lang=zh`
- **连接成功返回(服务端首帧建议)**
- `event``ws.connected`
- `connection_id`:连接唯一标识