变更记录

租户 API 的版本在网址中（/api/tenant/v1）。v1 承诺向下兼容：添加端点、字段或错误码属于兼容变更，请让你的程序忽略不认得的字段。会造成不兼容的变更只会出现在新的主版本；弃用至少提前 90 天在这里与 Console 公告。

v1.4.0 — 2026-10-05

兼容变更（添加玩法与投注区代码，请让程序接受不认得的 variant 与 zone）。

德州扑克玩家对荷官添加玩法 thbp（Texas Hold'em Bonus Poker；平台模拟桌 H03，沙箱已激活）：投注区 ANTE（底注）、FLOP（翻牌注，2 倍底注）、TURN（转牌注，1 倍底注）、RIVER（河牌注，1 倍底注）、BONUS（红利注）。result.code 为 player_wins、dealer_wins、tie、fold（没有 dealer_not_qualified）。规则与默认赔率见桌台与局结果。

兼容变更（添加游戏、投注区、字段与 GFI 事件，请让程序接受不认得的 game、zone 与字段）。

真人牛牛（game: "niuniu"、variant: "standard"；平台模拟桌 N01，沙箱已激活）：荷官的庄对闲一、闲二、闲三，投注区 P1E、P2E、P3E（平倍）与 P1D、P2D、P3D（翻倍）。规则、倍数与预扣见桌台与局结果。
注单（GET /bets、Webhook bet.settled、round.corrected、round.voided）：牛牛的注单多 hold（翻倍的预扣合计），翻倍格的 bets[] 多 hold、mult，result 多 hands、winners。payout 含退回的预扣，输赢请一律用 winLoss（＝payout − stake − hold），见注单同步。
结果码与牌面字符串：牛牛的 code 为 5 个字符（例如 5893A），cardInfo 为 头牌|庄|闲一|闲二|闲三；GET /rounds/{roundId} 的 result 为牛牛的结构化结果。见桌台与局结果。
GET /bets/summary：牛牛的注单在 payout 以「本金＋输赢」计入，不含退回的预扣。
数据源接口 GFI：game: "niuniu"，牌位 F（头牌）、B-1～B-5、P1-1～P3-5；card 添加选填的 faceDown（暗发，开牌前不公开牌面）；新事件 reveal（逐家开牌）。见事件与数据模型。

兼容变更（添加游戏、投注区与字段，请让程序接受不认得的 game、zone 与字段）。

德州扑克（game: "holdem"）：玩法 casino（玩家对荷官）、nlhe（玩家对玩家）；投注区 ANTE、CALL、AAB、POT。注单（GET /bets、Webhook bet.settled）另有 rake、onsite、hand，result 的格式见注单同步。
GET /bets/summary 每位玩家多一个 rake（德州玩家对玩家桌的抽水）。
跨商户提供：GET /tables 会列出其他商户提供给你的桌（有 provider），激活、禁用与平台桌相同，见桌台与局结果。

兼容变更（添加投注区代码，请让程序接受不认得的 zone）。

龙虎添加「大小单双」投注区：DB 龙大、DS 龙小、DO 龙单、DE 龙双、TB 虎大、TS 虎小、TO 虎单、TE 虎双。只在您于 Console「桌台设置」打开的龙虎桌提供（默认关闭）；规则与赔率见桌台与局。注单（GET /bets、Webhook bet.settled）的 bets[].zone 可能出现这些代码。
结果没有牌面（GFI complete: false）时，同花和与大小单双的注全额退回。

第一个正式版本。

租户 API

认证：HMAC-SHA256 签名（X-Api-Key、X-Timestamp、X-Nonce、X-Signature），±300 秒时间窗、10 分钟 nonce 防重放、IP 白名单、每租户限流。
玩家：POST /player/launch（一次性 60 秒启动网址、自动创建玩家、单一登录）、POST /player/logout、GET /player、POST /player/update。
转账钱包：POST /wallet/deposit、POST /wallet/withdraw（以 txnId 幂等）、GET /wallet/transfer、GET /wallet/balance。
注单：GET /bets（游标增量同步、rev 版次）、GET /bets/summary（每日每玩家汇总）。
桌台与局：GET /tables、POST /tables/enable、POST /tables/disable、GET /rounds/{roundId}。
账务：GET /account、GET /account/usage、GET /account/statements。

Webhook

局事件 bet.settled、round.corrected、round.voided（注单格式与 GET /bets 相同）、玩家事件 player.kicked、账务事件 account.grace、account.downgraded、account.restored、account.topup、account.low_balance，以及 test。
X-Elite-Signature HMAC 签名；失败时指数退避重试约 24 小时。沙箱租户也会送出局事件。

数据源接口

文档与工具

单一钱包（Seamless Wallet）：本平台在下注与结算时调用你的钱包端点。牛牛押翻倍时，下注的扣款（debit）金额包含预扣，结算的入账（credit）包含退回的预扣。