数据模型
各端点共用的数据结构。
Username
类型：string
玩家账号，1–32 个字符（字母或数字与 _ . @ -）；不分大小写（Alice 与 alice 是同一位玩家）。
格式：^[A-Za-z0-9_.@-]{1,32}$
TxnId
类型：string
你的转账单号，1–64 个字符（字母或数字与 _ . : -），作为幂等键。请在你的整个租户内保持唯一（不要在不同玩家之间重复使用）。
格式：^[A-Za-z0-9_.:-]{1,64}$
Amount
类型：string
玩家金额，十进制字符串，最多 4 位小数；响应会去掉小数尾端的 0（例如 "100"、"0.95"、"1000.5"）。
格式：^-?\d{1,15}(\.\d{1,4})?$
PositiveAmount
类型：string
大于 0 的金额，十进制字符串，最多 4 位小数，例如 "1000"、"99.5"。请用字符串，不要用浮点数。
格式：^\d{1,15}(\.\d{1,4})?$
UsdAmount
类型：string
USD 金额，十进制字符串，最多 6 位小数（内部以百万分之一美元累计）。
格式：^-?\d{1,12}(\.\d{1,6})?$
Currency
类型：string
币种代码（3–5 个英文字母，不分大小写，例如 TWD、USD、USDT）。
格式：^[A-Za-z]{3,5}$
Lang
类型：string
游戏语言：CHT 繁中、CHS 简中、ENG 英文、JPN 日文、KOR 韩文、THAI 泰文、VIET 越南文、HIND 印地文、PHP 菲律宾文（不分大小写）。
可能的值：CHT、CHS、ENG、JPN、KOR、THAI、VIET、HIND、PHP
Date
类型：string
日期 YYYY-MM-DD。
格式：^\d{4}-\d{2}-\d{2}$
DateTime
类型：string (date-time)
UTC 时间，ISO-8601 含毫秒。
Cursor
类型：string
注单同步游标（yyyymm.序号）。请视为不透明字符串，原样保存与带回。
格式：^\d{6}\.\d+$
RoundId
类型：string
局 ID（26 字符大写 ULID）。
格式：^[0-9A-Z]{26}$
TableId
类型：string
桌号，例如 S01（见 GET /tables）。
长度：1–…
Game
类型：string
游戏：baccarat 百家乐、dragontiger 龙虎、holdem 德州扑克、niuniu 牛牛。
可能的值：baccarat、dragontiger、holdem、niuniu
Variant
类型：string
玩法：百家乐 classic（传统，庄赢抽 5%）、nocomm（免佣，庄 6 点赢赔一半、有超级六）；龙虎的玩法以桌台的 variants 为准；德州扑克 casino（玩家对荷官，Casino Hold'em）、thbp（玩家对荷官，Texas Hold'em Bonus Poker）、nlhe（玩家对玩家，无限注）；牛牛 standard。
LimitProfileId
类型：integer | null
限红方案 ID：你在 Console「限红方案」创建的方案，或平台范本；币种必须与玩家相同，否则回 INVALID_PARAMETER。null 改回默认。限红方案依游戏区分，只套用在同一种游戏的桌，其他游戏的桌使用默认方案。
范围：1–…
PlayerStatus
类型：string
active 正常；locked 锁定（不能进入游戏）；no_bet 禁止下注（可进入观看）。
可能的值：active、locked、no_bet
ErrorCode
类型：string
错误码，完整说明见〈错误码〉。
可能的值：UNAUTHORIZED、IP_NOT_ALLOWED、TENANT_SUSPENDED、RATE_LIMITED、PAYLOAD_TOO_LARGE、INVALID_JSON、NOT_FOUND、INTERNAL_ERROR、INVALID_PARAMETER、INVALID_USERNAME、INVALID_CURRENCY、CURRENCY_NOT_ENABLED、INVALID_AMOUNT、INVALID_CURSOR、CURRENCY_MISMATCH、PLAYER_NOT_FOUND、PLAYER_LOCKED、PLAYER_LIMIT、TXN_CONFLICT、INSUFFICIENT_BALANCE、TXN_NOT_FOUND、ROUND_NOT_FOUND、QUOTA_EXCEEDED、ACCOUNT_LOCKED
LaunchRequest
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
username | string | 是 | 玩家账号，1–32 个字符（字母或数字与 _ . @ -）；不分大小写（Alice 与 alice 是同一位玩家）。格式： ^[A-Za-z0-9_.@-]{1,32}$ |
nickname | string | 否 | 暱称（选填）。只在创建玩家时使用。 |
currency | string | 否 | 币种（选填），只在创建玩家时使用；默认为你的租户币种。 格式： ^[A-Za-z]{3,5}$ |
lang | string | 否 | 游戏语言（选填）；默认为你在 Console 设置的第一个语言，未设置时为 CHT。可能的值： CHT、CHS、ENG、JPN、KOR、THAI、VIET、HIND、PHP |
device | string | 否 | mobile 打开手机版，其他值一律为电脑版 pc。可能的值： pc、mobile默认： pc |
table | string | 否 | 直接进入这张桌（选填）；不带时进入大厅。桌必须是你已激活的桌。 长度：1–… |
variant | string | 否 | 偏好的百家乐玩法（选填，classic／nocomm）。目前版本只保存，玩家仍在桌内自行选择。 |
lobbyUrl | string (uri) | 否 | 你的网站网址（选填，http 或 https）。目前版本的「回到网站」按钮使用 Console「品牌与登录 → 返回大厅网址」的设置；这个参数会保存，供之后的版本逐次覆写。 格式： ^https?:// |
limitProfileId | integer | null | 否 | 限红方案 ID：你在 Console「限红方案」创建的方案，或平台范本；币种必须与玩家相同，否则回 INVALID_PARAMETER。null 改回默认。限红方案依游戏区分，只套用在同一种游戏的桌，其他游戏的桌使用默认方案。范围：1–… |
LaunchResult
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
url | string (uri) | 是 | 一次性游戏网址（https://<主机>/Launch?t=…），60 秒内有效、只能打开一次。 |
expiresIn | integer | 是 | 网址有效秒数。 固定为： 60 |
UsernameRequest
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
username | string | 是 | 玩家账号，1–32 个字符（字母或数字与 _ . @ -）；不分大小写（Alice 与 alice 是同一位玩家）。格式： ^[A-Za-z0-9_.@-]{1,32}$ |
LogoutResult
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
kicked | boolean | 是 | 一律为 true。 |
Player
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
username | string | 是 | 玩家账号（保留第一次创建时的大小写）。 |
nickname | string | null | 是 | 暱称。 |
status | string | 是 | active 正常；locked 锁定（不能进入游戏）；no_bet 禁止下注（可进入观看）。可能的值： active、locked、no_bet |
currency | string | 是 | 币种。 |
balance | string | 是 | 目前可用余额。 格式： ^-?\d{1,15}(\.\d{1,4})?$ |
online | boolean | 是 | 目前是否在游戏中（大厅或桌内）。 |
createdAt | string (date-time) | 是 | UTC 时间，ISO-8601 含毫秒。 |
lastLoginAt | string (date-time) | null | 是 | 最近一次进入游戏的时间。 |
PlayerUpdateRequest
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
username | string | 是 | 玩家账号，1–32 个字符（字母或数字与 _ . @ -）；不分大小写（Alice 与 alice 是同一位玩家）。格式： ^[A-Za-z0-9_.@-]{1,32}$ |
status | string | 否 | active 正常；locked 锁定（不能进入游戏）；no_bet 禁止下注（可进入观看）。可能的值： active、locked、no_bet |
nickname | string | null | 否 | 新暱称；null 或空字符串清除。 |
limitProfileId | integer | null | 否 | 限红方案 ID：你在 Console「限红方案」创建的方案，或平台范本；币种必须与玩家相同，否则回 INVALID_PARAMETER。null 改回默认。限红方案依游戏区分，只套用在同一种游戏的桌，其他游戏的桌使用默认方案。范围：1–… |
password | string | 否 | 公用登录（/Login）用的密码，6–64 个字符。长度：6–64 |
TransferRequest
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
username | string | 是 | 玩家账号，1–32 个字符（字母或数字与 _ . @ -）；不分大小写（Alice 与 alice 是同一位玩家）。格式： ^[A-Za-z0-9_.@-]{1,32}$ |
txnId | string | 是 | 你的转账单号，1–64 个字符（字母或数字与 _ . : -），作为幂等键。请在你的整个租户内保持唯一（不要在不同玩家之间重复使用）。格式： ^[A-Za-z0-9_.:-]{1,64}$ |
amount | string | 是 | 大于 0 的金额，十进制字符串，最多 4 位小数，例如 "1000"、"99.5"。请用字符串，不要用浮点数。格式： ^\d{1,15}(\.\d{1,4})?$ |
currency | string | 是 | 必须等于玩家的币种。 格式： ^[A-Za-z]{3,5}$ |
TransferResult
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
txnId | string | 是 | 请求的 txnId。 |
status | string | 是 | 一律为 done（单阶段，没有处理中状态）。 |
balance | string | 是 | 这笔转账完成当下的余额；重送同一个 txnId 时返回第一次的值。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
duplicate | boolean | 是 | true 表示这个 txnId 先前已处理过：这次没有再动到余额，响应是第一次的结果。 |
TransferRecord
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
txnId | string | 是 | 转账单号。 |
username | string | 是 | 玩家账号。 |
dir | string | 是 | in 转入、out 转出、adjust Console 人工上下分。可能的值： in、out、adjust |
amount | string | 是 | 金额（正数）。 格式： ^-?\d{1,15}(\.\d{1,4})?$ |
status | string | 是 | 一律为 done。 |
balance | string | null | 是 | 这笔转账完成后的余额。 |
at | string (date-time) | 是 | UTC 时间，ISO-8601 含毫秒。 |
Balance
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
balance | string | 是 | 玩家金额，十进制字符串，最多 4 位小数；响应会去掉小数尾端的 0（例如 "100"、"0.95"、"1000.5"）。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
currency | string | 是 | 币种。 |
Zone
类型：string
投注区。百家乐：B 庄、P 闲、T 和、BP 庄对、PP 闲对、S6 超级六（免佣）。龙虎：D 龙、TG 虎、T 和、ST 同花和；大小单双（您在 Console 桌台设置打开的桌才有）：DB 龙大、DS 龙小、DO 龙单、DE 龙双、TB 虎大、TS 虎小、TO 虎单、TE 虎双。德州扑克：玩家对荷官 Casino Hold'em ANTE 底注、CALL 跟注（2 倍底注）、AAB AA 边注；玩家对荷官 Texas Hold'em Bonus ANTE 底注、FLOP 翻牌注（2 倍底注）、TURN 转牌注（1 倍底注）、RIVER 河牌注（1 倍底注）、BONUS 红利注；玩家对玩家 POT（这手投入底池的合计，return 为没被跟注退回的部分）。牛牛（都是押那一家闲赢庄）：P1E 闲一平倍、P1D 闲一翻倍、P2E 闲二平倍、P2D 闲二翻倍、P3E 闲三平倍、P3D 闲三翻倍。
可能的值：B、P、T、BP、PP、S6、D、TG、ST、DB、DS、DO、DE、TB、TS、TO、TE、ANTE、CALL、AAB、FLOP、TURN、RIVER、BONUS、POT、P1E、P1D、P2E、P2D、P3E、P3D
BetLeg
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
zone | string | 是 | 投注区。百家乐：B 庄、P 闲、T 和、BP 庄对、PP 闲对、S6 超级六（免佣）。龙虎：D 龙、TG 虎、T 和、ST 同花和；大小单双（您在 Console 桌台设置打开的桌才有）：DB 龙大、DS 龙小、DO 龙单、DE 龙双、TB 虎大、TS 虎小、TO 虎单、TE 虎双。德州扑克：玩家对荷官 Casino Hold'em ANTE 底注、CALL 跟注（2 倍底注）、AAB AA 边注；玩家对荷官 Texas Hold'em Bonus ANTE 底注、FLOP 翻牌注（2 倍底注）、TURN 转牌注（1 倍底注）、RIVER 河牌注（1 倍底注）、BONUS 红利注；玩家对玩家 POT（这手投入底池的合计，return 为没被跟注退回的部分）。牛牛（都是押那一家闲赢庄）：P1E 闲一平倍、P1D 闲一翻倍、P2E 闲二平倍、P2D 闲二翻倍、P3E 闲三平倍、P3D 闲三翻倍。可能的值： B、P、T、BP、PP、S6、D、TG、ST、DB、DS、DO、DE、TB、TS、TO、TE、ANTE、CALL、AAB、FLOP、TURN、RIVER、BONUS、POT、P1E、P1D、P2E、P2D、P3E、P3D |
amount | string | 是 | 本金。 格式： ^-?\d{1,15}(\.\d{1,4})?$ |
return | string | 是 | 退回金额（本金＋净赢；和局退回本金；输为 0）。牛牛翻倍格另含退回的预扣。 格式： ^-?\d{1,15}(\.\d{1,4})?$ |
hold | string | 否 | 只有牛牛翻倍格（P1D、P2D、P3D）：这一格下注时另外预扣的金额（默认为本金 × 2），没用到的部分已含在 return。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
mult | integer | 否 | 只有牛牛翻倍格：实际套用的倍数。闲赢为闲家牌型的倍数、闲输为庄家牌型的倍数（默认 无牛～牛6 ×1、牛7～牛9 ×2、牛牛 ×3）；退款为 0。范围：0–10 |
NiuniuHands
类型：对应表<string, integer>
牛牛各家的牌型代码，键 B 庄、P1～P3 闲一～闲三；值 0 无牛、1–9 牛几、10 牛牛、11 五花牛、12 炸弹、13 五小牛（11–13 只在打开特殊牌型的桌出现）。结果不完整时只有已知的家。
键：B、P1、P2、P3
NiuniuWinners
类型：对应表<string, string>
牛牛每一家闲对庄的输赢：P 闲赢、B 庄赢（没有和局）。
键：P1、P2、P3
ResultCode
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
code | string | 是 | 结果码（一个十六进制字符，格式见〈桌台与局结果〉）；作废且没有结果时为空字符串。德州扑克为这位玩家这手的结果：玩家对荷官 player_wins、dealer_wins、tie、dealer_not_qualified（只有 Casino Hold'em）、fold；玩家对玩家 win、split、lose、fold；作废 void。牛牛为 5 个字符 [胜负][庄][闲一][闲二][闲三]：第一个字符是闲家赢的比特（闲一 1、闲二 2、闲三 4 相加，0–7），之后是各家的牌型（0–9、A 牛牛、B 五花牛、C 炸弹、D 五小牛、- 不知道），例如 5893A。 |
cardInfo | string | 是 | 牌面字符串（百家乐 12 字符、龙虎 4 字符，格式见〈桌台与局结果〉）；没有结果时为空字符串。德州扑克为 公牌|这位玩家的两张底牌|荷官的两张（空白分隔的牌面代码，荷官只有玩家对荷官桌才有），例如 AS KD 7H 7C 2S|AH 7D|QS 3C。牛牛为 头牌|庄|闲一|闲二|闲三（每家 5 张依 1–5 的顺序，空白分隔），例如 7H|KS QD 10C 3S 5H|4C 6D JS 9C KH|2D 8S QC AH 2C|7D 3H KD 5C 5D。 |
hands | 对应表<string, integer> | 否 | 只有牛牛：各家的牌型代码（B、P1、P2、P3 → 0–13），不必自己解结果码。作废（status: void）的注单没有这个字段。键： B、P1、P2、P3 |
winners | 对应表<string, string> | 否 | 只有牛牛：每一家闲对庄的输赢（P1、P2、P3 → P 闲赢、B 庄赢）。作废（status: void）的注单没有这个字段。键： P1、P2、P3 |
BetRecord
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
recSeq | integer | 是 | 写入序号（同一个 UTC 月份内递增）。 |
slipId | string | 是 | 注单 ID：一位玩家在一局的所有下注为一张注单。重算与作废沿用同一个 slipId。 |
rev | integer | 是 | 版次。同一 slipId 以最大的 rev 为准。范围：1–… |
status | string | 是 | settled 首次结算；recalculated 结果修正后重算；void 作废（全额退回本金；牛牛连同预扣）。可能的值： settled、recalculated、void |
username | string | 是 | 玩家账号。 |
currency | string | 是 | 币种。 |
tableId | string | 是 | 桌号，例如 S01（见 GET /tables）。长度：1–… |
game | string | 是 | 游戏：baccarat 百家乐、dragontiger 龙虎、holdem 德州扑克、niuniu 牛牛。可能的值： baccarat、dragontiger、holdem、niuniu |
variant | string | 是 | 玩法：百家乐 classic（传统，庄赢抽 5%）、nocomm（免佣，庄 6 点赢赔一半、有超级六）；龙虎的玩法以桌台的 variants 为准；德州扑克 casino（玩家对荷官，Casino Hold'em）、thbp（玩家对荷官，Texas Hold'em Bonus Poker）、nlhe（玩家对玩家，无限注）；牛牛 standard。 |
roundId | string | 是 | 局 ID；德州扑克为这一手的 ID（handId）。 格式： ^[0-9A-Z]{26}$ |
shoe | string | 是 | 靴号；德州扑克没有靴，为空字符串；牛牛每局一副新牌，这里是场次（默认每 60 局换一场）。 |
round | integer | 是 | 本靴第几局；德州扑克为这张桌的第几手；牛牛为本场次第几局。 |
bets | BetLeg[] | 是 | 各投注区的本金与退回。 |
bets[].zone | string | 是 | 投注区。百家乐：B 庄、P 闲、T 和、BP 庄对、PP 闲对、S6 超级六（免佣）。龙虎：D 龙、TG 虎、T 和、ST 同花和；大小单双（您在 Console 桌台设置打开的桌才有）：DB 龙大、DS 龙小、DO 龙单、DE 龙双、TB 虎大、TS 虎小、TO 虎单、TE 虎双。德州扑克：玩家对荷官 Casino Hold'em ANTE 底注、CALL 跟注（2 倍底注）、AAB AA 边注；玩家对荷官 Texas Hold'em Bonus ANTE 底注、FLOP 翻牌注（2 倍底注）、TURN 转牌注（1 倍底注）、RIVER 河牌注（1 倍底注）、BONUS 红利注；玩家对玩家 POT（这手投入底池的合计，return 为没被跟注退回的部分）。牛牛（都是押那一家闲赢庄）：P1E 闲一平倍、P1D 闲一翻倍、P2E 闲二平倍、P2D 闲二翻倍、P3E 闲三平倍、P3D 闲三翻倍。可能的值： B、P、T、BP、PP、S6、D、TG、ST、DB、DS、DO、DE、TB、TS、TO、TE、ANTE、CALL、AAB、FLOP、TURN、RIVER、BONUS、POT、P1E、P1D、P2E、P2D、P3E、P3D |
bets[].amount | string | 是 | 本金。 格式： ^-?\d{1,15}(\.\d{1,4})?$ |
bets[].return | string | 是 | 退回金额（本金＋净赢；和局退回本金；输为 0）。牛牛翻倍格另含退回的预扣。 格式： ^-?\d{1,15}(\.\d{1,4})?$ |
bets[].hold | string | 否 | 只有牛牛翻倍格（P1D、P2D、P3D）：这一格下注时另外预扣的金额（默认为本金 × 2），没用到的部分已含在 return。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
bets[].mult | integer | 否 | 只有牛牛翻倍格：实际套用的倍数。闲赢为闲家牌型的倍数、闲输为庄家牌型的倍数（默认 无牛～牛6 ×1、牛7～牛9 ×2、牛牛 ×3）；退款为 0。范围：0–10 |
stake | string | 是 | 本金合计（牛牛不含预扣）。 格式： ^-?\d{1,15}(\.\d{1,4})?$ |
hold | string | 否 | 只有牛牛：翻倍的预扣合计（各翻倍格的 bets[].hold 相加；没有押翻倍时为 0）。翻倍可能输超过本金（默认最多本金的 3 倍），所以下注时除了本金，另外从余额预扣这笔金额，结算时把没用到的部分连同派彩一起退回（含在 payout）。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
validStake | string | 是 | 有效投注（庄闲对押、和局等依规则扣除）。牛牛：平倍为本金、翻倍为本金 × 实际倍数（bets[].mult），退款的格子不算。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
rolling | string | 是 | 洗码量（输掉的注，超级六不计）。牛牛为输掉的金额（翻倍输的是本金 × 庄家牌型的倍数）。 格式： ^-?\d{1,15}(\.\d{1,4})?$ |
payout | string | 是 | 派彩合计（含本金）；牛牛另含退回的预扣。 格式： ^-?\d{1,15}(\.\d{1,4})?$ |
winLoss | string | 是 | 玩家输赢 = payout − stake（正数玩家赢）；牛牛为 payout − stake − hold。对账请一律用这个字段。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
delta | string | 是 | 这一版对玩家余额的入账差额：首次结算为 payout；重算为新旧派彩差（可为负）；作废为本金（牛牛再加预扣）减去先前的派彩。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
result | ResultCode | 是 | |
result.code | string | 是 | 结果码（一个十六进制字符，格式见〈桌台与局结果〉）；作废且没有结果时为空字符串。德州扑克为这位玩家这手的结果：玩家对荷官 player_wins、dealer_wins、tie、dealer_not_qualified（只有 Casino Hold'em）、fold；玩家对玩家 win、split、lose、fold；作废 void。牛牛为 5 个字符 [胜负][庄][闲一][闲二][闲三]：第一个字符是闲家赢的比特（闲一 1、闲二 2、闲三 4 相加，0–7），之后是各家的牌型（0–9、A 牛牛、B 五花牛、C 炸弹、D 五小牛、- 不知道），例如 5893A。 |
result.cardInfo | string | 是 | 牌面字符串（百家乐 12 字符、龙虎 4 字符，格式见〈桌台与局结果〉）；没有结果时为空字符串。德州扑克为 公牌|这位玩家的两张底牌|荷官的两张（空白分隔的牌面代码，荷官只有玩家对荷官桌才有），例如 AS KD 7H 7C 2S|AH 7D|QS 3C。牛牛为 头牌|庄|闲一|闲二|闲三（每家 5 张依 1–5 的顺序，空白分隔），例如 7H|KS QD 10C 3S 5H|4C 6D JS 9C KH|2D 8S QC AH 2C|7D 3H KD 5C 5D。 |
result.hands | 对应表<string, integer> | 否 | 只有牛牛：各家的牌型代码（B、P1、P2、P3 → 0–13），不必自己解结果码。作废（status: void）的注单没有这个字段。键： B、P1、P2、P3 |
result.winners | 对应表<string, string> | 否 | 只有牛牛：每一家闲对庄的输赢（P1、P2、P3 → P 闲赢、B 庄赢）。作废（status: void）的注单没有这个字段。键： P1、P2、P3 |
rake | string | 否 | 只有德州扑克：这手归这位玩家的抽水（玩家对玩家桌；玩家对荷官桌为 0）。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
onsite | boolean | 否 | 只有德州扑克：现场座位（开桌商户的现场客人，荷官在平板登记、不走钱包；username 为「现场 |
hand | object | 否 | 只有德州扑克：这一手的结果摘要（完整手牌记录在 Console「德州扑克记录」）。 |
hand.handId | string | 是 | 这一手的 ID（同 roundId）。 |
hand.no | integer | 是 | 这张桌的第几手（同 round）。 |
hand.outcome | string | 是 | 这位玩家的结果（同 result.code）。 |
hand.cards | string | 是 | 公牌与这位玩家亮出的牌（同 result.cardInfo）。 |
placedAt | string (date-time) | 是 | UTC 时间，ISO-8601 含毫秒。 |
settledAt | string (date-time) | 是 | 这一版的结算（或重算、作废）时间。 |
BetPage
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
items | BetRecord[] | 是 | |
items[].recSeq | integer | 是 | 写入序号（同一个 UTC 月份内递增）。 |
items[].slipId | string | 是 | 注单 ID：一位玩家在一局的所有下注为一张注单。重算与作废沿用同一个 slipId。 |
items[].rev | integer | 是 | 版次。同一 slipId 以最大的 rev 为准。范围：1–… |
items[].status | string | 是 | settled 首次结算；recalculated 结果修正后重算；void 作废（全额退回本金；牛牛连同预扣）。可能的值： settled、recalculated、void |
items[].username | string | 是 | 玩家账号。 |
items[].currency | string | 是 | 币种。 |
items[].tableId | string | 是 | 桌号，例如 S01（见 GET /tables）。长度：1–… |
items[].game | string | 是 | 游戏：baccarat 百家乐、dragontiger 龙虎、holdem 德州扑克、niuniu 牛牛。可能的值： baccarat、dragontiger、holdem、niuniu |
items[].variant | string | 是 | 玩法：百家乐 classic（传统，庄赢抽 5%）、nocomm（免佣，庄 6 点赢赔一半、有超级六）；龙虎的玩法以桌台的 variants 为准；德州扑克 casino（玩家对荷官，Casino Hold'em）、thbp（玩家对荷官，Texas Hold'em Bonus Poker）、nlhe（玩家对玩家，无限注）；牛牛 standard。 |
items[].roundId | string | 是 | 局 ID；德州扑克为这一手的 ID（handId）。 格式： ^[0-9A-Z]{26}$ |
items[].shoe | string | 是 | 靴号；德州扑克没有靴，为空字符串；牛牛每局一副新牌，这里是场次（默认每 60 局换一场）。 |
items[].round | integer | 是 | 本靴第几局；德州扑克为这张桌的第几手；牛牛为本场次第几局。 |
items[].bets | BetLeg[] | 是 | 各投注区的本金与退回。 |
items[].bets[].zone | string | 是 | 投注区。百家乐：B 庄、P 闲、T 和、BP 庄对、PP 闲对、S6 超级六（免佣）。龙虎：D 龙、TG 虎、T 和、ST 同花和；大小单双（您在 Console 桌台设置打开的桌才有）：DB 龙大、DS 龙小、DO 龙单、DE 龙双、TB 虎大、TS 虎小、TO 虎单、TE 虎双。德州扑克：玩家对荷官 Casino Hold'em ANTE 底注、CALL 跟注（2 倍底注）、AAB AA 边注；玩家对荷官 Texas Hold'em Bonus ANTE 底注、FLOP 翻牌注（2 倍底注）、TURN 转牌注（1 倍底注）、RIVER 河牌注（1 倍底注）、BONUS 红利注；玩家对玩家 POT（这手投入底池的合计，return 为没被跟注退回的部分）。牛牛（都是押那一家闲赢庄）：P1E 闲一平倍、P1D 闲一翻倍、P2E 闲二平倍、P2D 闲二翻倍、P3E 闲三平倍、P3D 闲三翻倍。可能的值： B、P、T、BP、PP、S6、D、TG、ST、DB、DS、DO、DE、TB、TS、TO、TE、ANTE、CALL、AAB、FLOP、TURN、RIVER、BONUS、POT、P1E、P1D、P2E、P2D、P3E、P3D |
items[].bets[].amount | string | 是 | 本金。 格式： ^-?\d{1,15}(\.\d{1,4})?$ |
items[].bets[].return | string | 是 | 退回金额（本金＋净赢；和局退回本金；输为 0）。牛牛翻倍格另含退回的预扣。 格式： ^-?\d{1,15}(\.\d{1,4})?$ |
items[].bets[].hold | string | 否 | 只有牛牛翻倍格（P1D、P2D、P3D）：这一格下注时另外预扣的金额（默认为本金 × 2），没用到的部分已含在 return。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
items[].bets[].mult | integer | 否 | 只有牛牛翻倍格：实际套用的倍数。闲赢为闲家牌型的倍数、闲输为庄家牌型的倍数（默认 无牛～牛6 ×1、牛7～牛9 ×2、牛牛 ×3）；退款为 0。范围：0–10 |
items[].stake | string | 是 | 本金合计（牛牛不含预扣）。 格式： ^-?\d{1,15}(\.\d{1,4})?$ |
items[].hold | string | 否 | 只有牛牛：翻倍的预扣合计（各翻倍格的 bets[].hold 相加；没有押翻倍时为 0）。翻倍可能输超过本金（默认最多本金的 3 倍），所以下注时除了本金，另外从余额预扣这笔金额，结算时把没用到的部分连同派彩一起退回（含在 payout）。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
items[].validStake | string | 是 | 有效投注（庄闲对押、和局等依规则扣除）。牛牛：平倍为本金、翻倍为本金 × 实际倍数（bets[].mult），退款的格子不算。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
items[].rolling | string | 是 | 洗码量（输掉的注，超级六不计）。牛牛为输掉的金额（翻倍输的是本金 × 庄家牌型的倍数）。 格式： ^-?\d{1,15}(\.\d{1,4})?$ |
items[].payout | string | 是 | 派彩合计（含本金）；牛牛另含退回的预扣。 格式： ^-?\d{1,15}(\.\d{1,4})?$ |
items[].winLoss | string | 是 | 玩家输赢 = payout − stake（正数玩家赢）；牛牛为 payout − stake − hold。对账请一律用这个字段。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
items[].delta | string | 是 | 这一版对玩家余额的入账差额：首次结算为 payout；重算为新旧派彩差（可为负）；作废为本金（牛牛再加预扣）减去先前的派彩。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
items[].result | ResultCode | 是 | |
items[].result.code | string | 是 | 结果码（一个十六进制字符，格式见〈桌台与局结果〉）；作废且没有结果时为空字符串。德州扑克为这位玩家这手的结果：玩家对荷官 player_wins、dealer_wins、tie、dealer_not_qualified（只有 Casino Hold'em）、fold；玩家对玩家 win、split、lose、fold；作废 void。牛牛为 5 个字符 [胜负][庄][闲一][闲二][闲三]：第一个字符是闲家赢的比特（闲一 1、闲二 2、闲三 4 相加，0–7），之后是各家的牌型（0–9、A 牛牛、B 五花牛、C 炸弹、D 五小牛、- 不知道），例如 5893A。 |
items[].result.cardInfo | string | 是 | 牌面字符串（百家乐 12 字符、龙虎 4 字符，格式见〈桌台与局结果〉）；没有结果时为空字符串。德州扑克为 公牌|这位玩家的两张底牌|荷官的两张（空白分隔的牌面代码，荷官只有玩家对荷官桌才有），例如 AS KD 7H 7C 2S|AH 7D|QS 3C。牛牛为 头牌|庄|闲一|闲二|闲三（每家 5 张依 1–5 的顺序，空白分隔），例如 7H|KS QD 10C 3S 5H|4C 6D JS 9C KH|2D 8S QC AH 2C|7D 3H KD 5C 5D。 |
items[].result.hands | 对应表<string, integer> | 否 | 只有牛牛：各家的牌型代码（B、P1、P2、P3 → 0–13），不必自己解结果码。作废（status: void）的注单没有这个字段。键： B、P1、P2、P3 |
items[].result.winners | 对应表<string, string> | 否 | 只有牛牛：每一家闲对庄的输赢（P1、P2、P3 → P 闲赢、B 庄赢）。作废（status: void）的注单没有这个字段。键： P1、P2、P3 |
items[].rake | string | 否 | 只有德州扑克：这手归这位玩家的抽水（玩家对玩家桌；玩家对荷官桌为 0）。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
items[].onsite | boolean | 否 | 只有德州扑克：现场座位（开桌商户的现场客人，荷官在平板登记、不走钱包；username 为「现场 |
items[].hand | object | 否 | 只有德州扑克：这一手的结果摘要（完整手牌记录在 Console「德州扑克记录」）。 |
items[].hand.handId | string | 是 | 这一手的 ID（同 roundId）。 |
items[].hand.no | integer | 是 | 这张桌的第几手（同 round）。 |
items[].hand.outcome | string | 是 | 这位玩家的结果（同 result.code）。 |
items[].hand.cards | string | 是 | 公牌与这位玩家亮出的牌（同 result.cardInfo）。 |
items[].placedAt | string (date-time) | 是 | UTC 时间，ISO-8601 含毫秒。 |
items[].settledAt | string (date-time) | 是 | 这一版的结算（或重算、作废）时间。 |
nextCursor | string | 是 | 注单同步游标（yyyymm.序号）。请视为不透明字符串，原样保存与带回。格式： ^\d{6}\.\d+$ |
hasMore | boolean | 是 | true 表示可能还有下一页，请立即再读。 |
PlayerDaySummary
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
username | string | 是 | 玩家账号。 |
slips | integer | 是 | 注单数（含作废）。 |
stake | string | 是 | 本金合计（不含作废）。 格式： ^-?\d{1,15}(\.\d{1,4})?$ |
validStake | string | 是 | 玩家金额，十进制字符串，最多 4 位小数；响应会去掉小数尾端的 0（例如 "100"、"0.95"、"1000.5"）。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
rolling | string | 是 | 玩家金额，十进制字符串，最多 4 位小数；响应会去掉小数尾端的 0（例如 "100"、"0.95"、"1000.5"）。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
payout | string | 是 | 派彩合计（含本金）。牛牛的注单以「本金＋输赢」计入，不含退回的预扣（注单本身的 payout 含预扣）。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
winLoss | string | 是 | 玩家金额，十进制字符串，最多 4 位小数；响应会去掉小数尾端的 0（例如 "100"、"0.95"、"1000.5"）。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
rake | string | 否 | 德州扑克玩家对玩家桌的抽水合计（其他游戏为 0）。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
BetSummary
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
date | string | 是 | 日期 YYYY-MM-DD。格式： ^\d{4}-\d{2}-\d{2}$ |
timezone | string | 是 | 租户时区（IANA，例如 Asia/Taipei）。 |
players | PlayerDaySummary[] | 是 | |
players[].username | string | 是 | 玩家账号。 |
players[].slips | integer | 是 | 注单数（含作废）。 |
players[].stake | string | 是 | 本金合计（不含作废）。 格式： ^-?\d{1,15}(\.\d{1,4})?$ |
players[].validStake | string | 是 | 玩家金额，十进制字符串，最多 4 位小数；响应会去掉小数尾端的 0（例如 "100"、"0.95"、"1000.5"）。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
players[].rolling | string | 是 | 玩家金额，十进制字符串，最多 4 位小数；响应会去掉小数尾端的 0（例如 "100"、"0.95"、"1000.5"）。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
players[].payout | string | 是 | 派彩合计（含本金）。牛牛的注单以「本金＋输赢」计入，不含退回的预扣（注单本身的 payout 含预扣）。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
players[].winLoss | string | 是 | 玩家金额，十进制字符串，最多 4 位小数；响应会去掉小数尾端的 0（例如 "100"、"0.95"、"1000.5"）。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
players[].rake | string | 否 | 德州扑克玩家对玩家桌的抽水合计（其他游戏为 0）。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
BaccaratResult
百家乐结果（与数据源接口 GFI 相同）。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
cards | 对应表<string, string> | 否 | 牌面，位置 P1 B1 P2 B2 P3 B3，未发的牌省略；牌面格式如 AS、10H、QD。键： P1、B1、P2、B2、P3、B3 |
player | integer | 是 | 范围：0–9 |
banker | integer | 是 | 范围：0–9 |
winner | string | 是 | 可能的值：P、B、T |
playerPair | boolean | 是 | |
bankerPair | boolean | 是 | |
cardCount | integer | 否 | 范围：4–6 |
DragonTigerResult
龙虎结果（与数据源接口 GFI 相同）。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
cards | object | 否 | |
cards.D | string | 是 | 格式：^(A|[2-9]|10|J|Q|K)[SHDC]$ |
cards.T | string | 是 | 格式：^(A|[2-9]|10|J|Q|K)[SHDC]$ |
winner | string | 是 | 可能的值：D、T、TIE |
NiuniuResult
牛牛结果（与数据源接口 GFI 相同）。各家输赢以平台依牌面重算的结果码 code 为准。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
cards | 对应表<string, string> | 否 | 牌面，牌位 F 头牌、B-1～B-5 庄、P1-1～P1-5 闲一、P2-1～P2-5 闲二、P3-1～P3-5 闲三（完整结果 21 张）；牌面格式如 AS、10H、QD。键： F、B-1、B-2、B-3、B-4、B-5、P1-1、P1-2、P1-3、P1-4、P1-5、P2-1、P2-2、P2-3、P2-4、P2-5、P3-1、P3-2、P3-3、P3-4、P3-5 |
hands | 对应表<string, integer> | 否 | 牛牛各家的牌型代码，键 B 庄、P1～P3 闲一～闲三；值 0 无牛、1–9 牛几、10 牛牛、11 五花牛、12 炸弹、13 五小牛（11–13 只在打开特殊牌型的桌出现）。结果不完整时只有已知的家。键： B、P1、P2、P3 |
winners | 对应表<string, string> | 是 | 牛牛每一家闲对庄的输赢：P 闲赢、B 庄赢（没有和局）。键： P1、P2、P3 |
Round
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
roundId | string | 是 | 局 ID（26 字符大写 ULID）。 格式： ^[0-9A-Z]{26}$ |
tableId | string | 是 | 桌号，例如 S01（见 GET /tables）。长度：1–… |
shoe | string | 是 | 靴号；牛牛为场次。 |
round | integer | 是 | 本靴第几局；牛牛为本场次第几局。 |
status | string | 是 | settled 已结算；void 作废；disputed 争议局（结算后收到超出护栏的修正或作废，维持原结果、不动金额）。可能的值： settled、void、disputed |
code | string | null | 是 | 结果码（百家乐、龙虎为一个十六进制字符；牛牛为 5 个字符，例如 5893A）。 |
cardInfo | string | null | 是 | 牌面字符串（牛牛为 头牌|庄|闲一|闲二|闲三）。 |
result | BaccaratResult | DragonTigerResult | NiuniuResult | null | 是 | 结构化结果（百家乐、龙虎或牛牛）；没有结果时为 null。 |
complete | boolean | null | 是 | true 表示有完整牌面；false 表示数据源只提供了输赢与点数（牛牛为各家输赢，可能附牌型）。 |
rev | integer | 是 | 结果版次（第一次结果为 1，每次修正 +1；作废也会 +1）。 |
openedAt | string (date-time) | null | 是 | 开放下注时间。 |
settledAt | string (date-time) | null | 是 | 首次结算时间。 |
Table
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
tableId | string | 是 | 桌号，例如 S01（见 GET /tables）。长度：1–… |
game | string | 是 | 游戏：baccarat 百家乐、dragontiger 龙虎、holdem 德州扑克、niuniu 牛牛。可能的值： baccarat、dragontiger、holdem、niuniu |
variants | string[] | 是 | 这张桌提供的玩法。 |
name | 对应表<string, string> | 是 | 各语言的桌名，键为语言代码（CHT、CHS、ENG…）。 |
status | string | 是 | open 开放；maintenance 维护中（数据源中断等）。可能的值： open、maintenance |
betSeconds | integer | 是 | 默认下注秒数。 |
enabled | boolean | 是 | 你是否已激活这张桌。 |
provider | object | 否 | 只有其他商户提供给你的桌（跨商户提供）才有：提供者。玩家用你的限红、钱照旧由你结算，使用这张桌也算进你的桌数。 |
provider.name | string | 是 | 提供者名称。 |
TableList
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
tables | Table[] | 是 | |
tables[].tableId | string | 是 | 桌号，例如 S01（见 GET /tables）。长度：1–… |
tables[].game | string | 是 | 游戏：baccarat 百家乐、dragontiger 龙虎、holdem 德州扑克、niuniu 牛牛。可能的值： baccarat、dragontiger、holdem、niuniu |
tables[].variants | string[] | 是 | 这张桌提供的玩法。 |
tables[].name | 对应表<string, string> | 是 | 各语言的桌名，键为语言代码（CHT、CHS、ENG…）。 |
tables[].status | string | 是 | open 开放；maintenance 维护中（数据源中断等）。可能的值： open、maintenance |
tables[].betSeconds | integer | 是 | 默认下注秒数。 |
tables[].enabled | boolean | 是 | 你是否已激活这张桌。 |
tables[].provider | object | 否 | 只有其他商户提供给你的桌（跨商户提供）才有：提供者。玩家用你的限红、钱照旧由你结算，使用这张桌也算进你的桌数。 |
tables[].provider.name | string | 是 | 提供者名称。 |
TableToggleRequest
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
tableId | string | 是 | 桌号，例如 S01（见 GET /tables）。长度：1–… |
TableToggleResult
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
tableId | string | 是 | 桌号，例如 S01（见 GET /tables）。长度：1–… |
enabled | boolean | 是 | 操作后是否激活。 |
used | integer | 是 | 目前已激活的桌数。 |
quota | integer | null | 是 | 方案可激活的桌数；付费方案为 null（不限）。 |
Account
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
plan | string | 是 | 方案：free 免费展示方案、paid 付费方案。可能的值： free、paid |
state | string | 是 | 账务状态，说明见〈计费说明〉。 可能的值： FREE、PAID、GRACE、DOWNGRADED、SUSPENDED、CLOSED |
balanceUsd | string | 是 | 预付额度余额（可为负数）。 格式： ^-?\d{1,12}(\.\d{1,6})?$ |
tablesUsed | integer | 是 | 已激活桌数。 |
tablesQuota | integer | null | 是 | 可激活桌数；付费方案为 null。 |
streamGbMonth | string | 是 | 本月（UTC）视频流用量（GB，3 位小数）。 |
avgDailyUsd7d | string | 是 | 近 7 天平均每日费用。 格式： ^-?\d{1,12}(\.\d{1,6})?$ |
daysLeft | integer | null | 是 | 以目前费用估计，预付额度约可再用几天；没有费用时为 null。 |
graceUntil | string (date-time) | null | 是 | 宽限期截止时间（只在 GRACE 状态）。 |
UsageDay
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
day | string | 是 | 日期 YYYY-MM-DD。格式： ^\d{4}-\d{2}-\d{2}$ |
tableDays | number | 是 | 当天计费的桌·日。 |
streamGb | string | 是 | 视频流用量（GB，3 位小数）。 |
streamSource | string | 是 | 视频流用量的依据：cdn 视频流服务依标签汇总、client 播放器回报、estimate 估算。可能的值： cdn、client、estimate |
tableFeeUsd | string | 是 | 桌费。 格式： ^-?\d{1,12}(\.\d{1,6})?$ |
streamFeeUsd | string | 是 | 视频流费。 格式： ^-?\d{1,12}(\.\d{1,6})?$ |
UsageList
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
days | UsageDay[] | 是 | |
days[].day | string | 是 | 日期 YYYY-MM-DD。格式： ^\d{4}-\d{2}-\d{2}$ |
days[].tableDays | number | 是 | 当天计费的桌·日。 |
days[].streamGb | string | 是 | 视频流用量（GB，3 位小数）。 |
days[].streamSource | string | 是 | 视频流用量的依据：cdn 视频流服务依标签汇总、client 播放器回报、estimate 估算。可能的值： cdn、client、estimate |
days[].tableFeeUsd | string | 是 | 桌费。 格式： ^-?\d{1,12}(\.\d{1,6})?$ |
days[].streamFeeUsd | string | 是 | 视频流费。 格式： ^-?\d{1,12}(\.\d{1,6})?$ |
Statement
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
period | string | 是 | 期间 YYYY-MM。格式： ^\d{4}-\d{2}$ |
openingUsd | string | 是 | 期初余额。 格式： ^-?\d{1,12}(\.\d{1,6})?$ |
chargesUsd | string | 是 | 扣款合计（负数）。 格式： ^-?\d{1,12}(\.\d{1,6})?$ |
paymentsUsd | string | 是 | 付款与加值合计。 格式： ^-?\d{1,12}(\.\d{1,6})?$ |
closingUsd | string | 是 | 期末余额。 格式： ^-?\d{1,12}(\.\d{1,6})?$ |
StatementList
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
statements | Statement[] | 是 | |
statements[].period | string | 是 | 期间 YYYY-MM。格式： ^\d{4}-\d{2}$ |
statements[].openingUsd | string | 是 | 期初余额。 格式： ^-?\d{1,12}(\.\d{1,6})?$ |
statements[].chargesUsd | string | 是 | 扣款合计（负数）。 格式： ^-?\d{1,12}(\.\d{1,6})?$ |
statements[].paymentsUsd | string | 是 | 付款与加值合计。 格式： ^-?\d{1,12}(\.\d{1,6})?$ |
statements[].closingUsd | string | 是 | 期末余额。 格式： ^-?\d{1,12}(\.\d{1,6})?$ |
WebhookEnvelope
所有 Webhook 共用的正文格式；data 依事件而定。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | string | 是 | 投递 ID（同 X-Elite-Delivery）；自动重试时不变，平台手动重送时会换新的。 |
event | string | 是 | 事件名称。 可能的值： bet.settled、round.corrected、round.voided、player.kicked、account.grace、account.downgraded、account.restored、account.topup、account.low_balance、test |
companyCode | string | 是 | 收到事件的租户公司代码（沙箱租户为 …-SBX）。 |
createdAt | string (date-time) | 是 | 这次投递产生的时间（每次重试都会更新）。 |
data | object | 是 | 事件内容，格式见各事件。 |
WebhookRound
局事件的局信息。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
roundId | string | 是 | 局 ID（26 字符大写 ULID）。 格式： ^[0-9A-Z]{26}$ |
tableId | string | 是 | 桌号，例如 S01（见 GET /tables）。长度：1–… |
shoe | string | null | 是 | 靴号（字符串）；牛牛为场次。 |
round | integer | null | 是 | 本靴第几局；牛牛为本场次第几局。 |
rev | integer | 是 | 这个事件对应的结果版次；data.bets 只包含这个版次的注单。范围：1–… |
resultCode | string | null | 是 | 结果码（百家乐、龙虎为一个十六进制字符；牛牛为 5 个字符）；没有结果的作废局为 null。 |
cardInfo | string | null | 是 | 牌面字符串（牛牛为 头牌|庄|闲一|闲二|闲三）；没有结果的作废局为 null。 |
settledAt | string (date-time) | null | 是 | 这一局首次结算（或作废）的时间。 |
RoundEventData
bet.settled、round.corrected、round.voided 的 data。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
round | WebhookRound | 是 | 局事件的局信息。 |
round.roundId | string | 是 | 局 ID（26 字符大写 ULID）。 格式： ^[0-9A-Z]{26}$ |
round.tableId | string | 是 | 桌号，例如 S01（见 GET /tables）。长度：1–… |
round.shoe | string | null | 是 | 靴号（字符串）；牛牛为场次。 |
round.round | integer | null | 是 | 本靴第几局；牛牛为本场次第几局。 |
round.rev | integer | 是 | 这个事件对应的结果版次；data.bets 只包含这个版次的注单。范围：1–… |
round.resultCode | string | null | 是 | 结果码（百家乐、龙虎为一个十六进制字符；牛牛为 5 个字符）；没有结果的作废局为 null。 |
round.cardInfo | string | null | 是 | 牌面字符串（牛牛为 头牌|庄|闲一|闲二|闲三）；没有结果的作废局为 null。 |
round.settledAt | string (date-time) | null | 是 | 这一局首次结算（或作废）的时间。 |
bets | BetRecord[] | 是 | 你的玩家在这一局、这个版次的注单，格式与 GET /bets 的 items 完全相同。 |
bets[].recSeq | integer | 是 | 写入序号（同一个 UTC 月份内递增）。 |
bets[].slipId | string | 是 | 注单 ID：一位玩家在一局的所有下注为一张注单。重算与作废沿用同一个 slipId。 |
bets[].rev | integer | 是 | 版次。同一 slipId 以最大的 rev 为准。范围：1–… |
bets[].status | string | 是 | settled 首次结算；recalculated 结果修正后重算；void 作废（全额退回本金；牛牛连同预扣）。可能的值： settled、recalculated、void |
bets[].username | string | 是 | 玩家账号。 |
bets[].currency | string | 是 | 币种。 |
bets[].tableId | string | 是 | 桌号，例如 S01（见 GET /tables）。长度：1–… |
bets[].game | string | 是 | 游戏：baccarat 百家乐、dragontiger 龙虎、holdem 德州扑克、niuniu 牛牛。可能的值： baccarat、dragontiger、holdem、niuniu |
bets[].variant | string | 是 | 玩法：百家乐 classic（传统，庄赢抽 5%）、nocomm（免佣，庄 6 点赢赔一半、有超级六）；龙虎的玩法以桌台的 variants 为准；德州扑克 casino（玩家对荷官，Casino Hold'em）、thbp（玩家对荷官，Texas Hold'em Bonus Poker）、nlhe（玩家对玩家，无限注）；牛牛 standard。 |
bets[].roundId | string | 是 | 局 ID；德州扑克为这一手的 ID（handId）。 格式： ^[0-9A-Z]{26}$ |
bets[].shoe | string | 是 | 靴号；德州扑克没有靴，为空字符串；牛牛每局一副新牌，这里是场次（默认每 60 局换一场）。 |
bets[].round | integer | 是 | 本靴第几局；德州扑克为这张桌的第几手；牛牛为本场次第几局。 |
bets[].bets | BetLeg[] | 是 | 各投注区的本金与退回。 |
bets[].bets[].zone | string | 是 | 投注区。百家乐：B 庄、P 闲、T 和、BP 庄对、PP 闲对、S6 超级六（免佣）。龙虎：D 龙、TG 虎、T 和、ST 同花和；大小单双（您在 Console 桌台设置打开的桌才有）：DB 龙大、DS 龙小、DO 龙单、DE 龙双、TB 虎大、TS 虎小、TO 虎单、TE 虎双。德州扑克：玩家对荷官 Casino Hold'em ANTE 底注、CALL 跟注（2 倍底注）、AAB AA 边注；玩家对荷官 Texas Hold'em Bonus ANTE 底注、FLOP 翻牌注（2 倍底注）、TURN 转牌注（1 倍底注）、RIVER 河牌注（1 倍底注）、BONUS 红利注；玩家对玩家 POT（这手投入底池的合计，return 为没被跟注退回的部分）。牛牛（都是押那一家闲赢庄）：P1E 闲一平倍、P1D 闲一翻倍、P2E 闲二平倍、P2D 闲二翻倍、P3E 闲三平倍、P3D 闲三翻倍。可能的值： B、P、T、BP、PP、S6、D、TG、ST、DB、DS、DO、DE、TB、TS、TO、TE、ANTE、CALL、AAB、FLOP、TURN、RIVER、BONUS、POT、P1E、P1D、P2E、P2D、P3E、P3D |
bets[].bets[].amount | string | 是 | 本金。 格式： ^-?\d{1,15}(\.\d{1,4})?$ |
bets[].bets[].return | string | 是 | 退回金额（本金＋净赢；和局退回本金；输为 0）。牛牛翻倍格另含退回的预扣。 格式： ^-?\d{1,15}(\.\d{1,4})?$ |
bets[].bets[].hold | string | 否 | 只有牛牛翻倍格（P1D、P2D、P3D）：这一格下注时另外预扣的金额（默认为本金 × 2），没用到的部分已含在 return。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
bets[].bets[].mult | integer | 否 | 只有牛牛翻倍格：实际套用的倍数。闲赢为闲家牌型的倍数、闲输为庄家牌型的倍数（默认 无牛～牛6 ×1、牛7～牛9 ×2、牛牛 ×3）；退款为 0。范围：0–10 |
bets[].stake | string | 是 | 本金合计（牛牛不含预扣）。 格式： ^-?\d{1,15}(\.\d{1,4})?$ |
bets[].hold | string | 否 | 只有牛牛：翻倍的预扣合计（各翻倍格的 bets[].hold 相加；没有押翻倍时为 0）。翻倍可能输超过本金（默认最多本金的 3 倍），所以下注时除了本金，另外从余额预扣这笔金额，结算时把没用到的部分连同派彩一起退回（含在 payout）。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
bets[].validStake | string | 是 | 有效投注（庄闲对押、和局等依规则扣除）。牛牛：平倍为本金、翻倍为本金 × 实际倍数（bets[].mult），退款的格子不算。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
bets[].rolling | string | 是 | 洗码量（输掉的注，超级六不计）。牛牛为输掉的金额（翻倍输的是本金 × 庄家牌型的倍数）。 格式： ^-?\d{1,15}(\.\d{1,4})?$ |
bets[].payout | string | 是 | 派彩合计（含本金）；牛牛另含退回的预扣。 格式： ^-?\d{1,15}(\.\d{1,4})?$ |
bets[].winLoss | string | 是 | 玩家输赢 = payout − stake（正数玩家赢）；牛牛为 payout − stake − hold。对账请一律用这个字段。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
bets[].delta | string | 是 | 这一版对玩家余额的入账差额：首次结算为 payout；重算为新旧派彩差（可为负）；作废为本金（牛牛再加预扣）减去先前的派彩。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
bets[].result | ResultCode | 是 | |
bets[].result.code | string | 是 | 结果码（一个十六进制字符，格式见〈桌台与局结果〉）；作废且没有结果时为空字符串。德州扑克为这位玩家这手的结果：玩家对荷官 player_wins、dealer_wins、tie、dealer_not_qualified（只有 Casino Hold'em）、fold；玩家对玩家 win、split、lose、fold；作废 void。牛牛为 5 个字符 [胜负][庄][闲一][闲二][闲三]：第一个字符是闲家赢的比特（闲一 1、闲二 2、闲三 4 相加，0–7），之后是各家的牌型（0–9、A 牛牛、B 五花牛、C 炸弹、D 五小牛、- 不知道），例如 5893A。 |
bets[].result.cardInfo | string | 是 | 牌面字符串（百家乐 12 字符、龙虎 4 字符，格式见〈桌台与局结果〉）；没有结果时为空字符串。德州扑克为 公牌|这位玩家的两张底牌|荷官的两张（空白分隔的牌面代码，荷官只有玩家对荷官桌才有），例如 AS KD 7H 7C 2S|AH 7D|QS 3C。牛牛为 头牌|庄|闲一|闲二|闲三（每家 5 张依 1–5 的顺序，空白分隔），例如 7H|KS QD 10C 3S 5H|4C 6D JS 9C KH|2D 8S QC AH 2C|7D 3H KD 5C 5D。 |
bets[].result.hands | 对应表<string, integer> | 否 | 只有牛牛：各家的牌型代码（B、P1、P2、P3 → 0–13），不必自己解结果码。作废（status: void）的注单没有这个字段。键： B、P1、P2、P3 |
bets[].result.winners | 对应表<string, string> | 否 | 只有牛牛：每一家闲对庄的输赢（P1、P2、P3 → P 闲赢、B 庄赢）。作废（status: void）的注单没有这个字段。键： P1、P2、P3 |
bets[].rake | string | 否 | 只有德州扑克：这手归这位玩家的抽水（玩家对玩家桌；玩家对荷官桌为 0）。格式： ^-?\d{1,15}(\.\d{1,4})?$ |
bets[].onsite | boolean | 否 | 只有德州扑克：现场座位（开桌商户的现场客人，荷官在平板登记、不走钱包；username 为「现场 |
bets[].hand | object | 否 | 只有德州扑克：这一手的结果摘要（完整手牌记录在 Console「德州扑克记录」）。 |
bets[].hand.handId | string | 是 | 这一手的 ID（同 roundId）。 |
bets[].hand.no | integer | 是 | 这张桌的第几手（同 round）。 |
bets[].hand.outcome | string | 是 | 这位玩家的结果（同 result.code）。 |
bets[].hand.cards | string | 是 | 公牌与这位玩家亮出的牌（同 result.cardInfo）。 |
bets[].placedAt | string (date-time) | 是 | UTC 时间，ISO-8601 含毫秒。 |
bets[].settledAt | string (date-time) | 是 | 这一版的结算（或重算、作废）时间。 |
PlayerKickedData
player.kicked 的 data。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
username | string | 是 | 玩家账号。 |
reason | string | 是 | logged_out：POST /player/logout；locked：POST /player/update 设为 locked。可能的值： logged_out、locked |
at | string (date-time) | 是 | UTC 时间，ISO-8601 含毫秒。 |
UsdCents
类型：string
USD 金额，四舍五入到分，固定 2 位小数（例如 "496.83"）。
格式：^-?\d+\.\d{2}$
AccountStateData
account.grace、account.downgraded、account.restored 的 data。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
from | string | 是 | 原本的账务状态。 可能的值： FREE、PAID、GRACE、DOWNGRADED、SUSPENDED、CLOSED |
to | string | 是 | 新的账务状态。 可能的值： PAID、GRACE、DOWNGRADED |
balanceUsd | string | 是 | USD 金额，四舍五入到分，固定 2 位小数（例如 "496.83"）。格式： ^-?\d+\.\d{2}$ |
graceUntil | string (date-time) | null | 是 | 宽限期截止时间（进入宽限期时）。 |
actor | string | 是 | 触发者：system（自动）或操作者。 |
AccountTopupData
account.topup 的 data。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
amountUsd | string | 是 | USD 金额，四舍五入到分，固定 2 位小数（例如 "496.83"）。格式： ^-?\d+\.\d{2}$ |
balanceUsd | string | 是 | USD 金额，四舍五入到分，固定 2 位小数（例如 "496.83"）。格式： ^-?\d+\.\d{2}$ |
ref | string | 是 | 付款参考编号（例如金流交易编号或 USDT 交易哈希）。 |
AccountLowBalanceData
account.low_balance 的 data。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
balanceUsd | string | 是 | USD 金额，四舍五入到分，固定 2 位小数（例如 "496.83"）。格式： ^-?\d+\.\d{2}$ |
avgDailyUsd | string | 是 | 近 7 天平均每日费用。 格式： ^-?\d+\.\d{2}$ |
daysLeft | integer | 是 | 以目前费用估计，预付额度约可再用的天数。 |
TestEventData
test 的 data。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
message | string | 是 | 固定为：elite webhook test |