變更紀錄

租戶 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）包含退回的預扣。