真人視訊 API 串接
把 elite 的真人桌提供給您的玩家有兩種方式：已經有會員與錢包系統的營運商，以真人遊戲 API 串接；還沒有自己會員系統的營運商，用自己網域的品牌登入網站上線。兩種方式使用同一批桌、同一個 Console 與同一套計費。百家樂、龍虎、德州撲克、牛牛都用同一套 API，新遊戲上線不必重新串接。
兩種上線方式
| API 串接 | 白牌登入網站 | |
|---|---|---|
| 適合 | 已經有會員與錢包系統的營運商 | 還沒有自己會員系統的營運商 |
| 玩家帳號 | 玩家第一次啟動遊戲或轉入時自動建立 | 在 Console 建立，玩家以帳號密碼登入 |
| 額度 | 以轉帳錢包 API 轉入、轉出 | 在 Console 上下分 |
| 入口 | 您的網站或 App，以導向或 iframe 開啟 | 您自己的網域（正式方案），四種版型任選 |
| 開發 | 需要伺服器端串接 | 不需要 |
真人遊戲 API 一覽
| 項目 | 內容 |
|---|---|
| 簽章 | 每個請求以 HMAC-SHA256 簽章（X-Api-Key、X-Timestamp、X-Nonce、X-Signature）；時間差須在 ±300 秒內、nonce 不可重複，可另設 IP 白名單 |
| 遊戲啟動 | POST /player/launch 回傳 60 秒內有效、只能使用一次的網址，進入大廳或指定的桌；電腦版或手機版、9 種語系，可導向或以 iframe 開啟 |
| 轉帳錢包 | 轉入、轉出、查詢轉帳與查詢餘額；以 txnId 冪等 |
| 注單同步 | GET /bets 以游標增量讀取；結果修正與作廢以同一張注單的新版次出現；另有每日每位玩家的彙總 |
| Webhook | 局結算、修正、作廢、玩家被踢出與帳務變化時簽章通知，失敗時重試約 24 小時（正式方案與沙箱） |
| 桌檯與帳務 | 桌檯清單、啟用與停用、局結果、預付額度與每日用量 |
只能由伺服器呼叫
API 由您的後端呼叫，Secret 絕不可放在瀏覽器或 App。
轉帳錢包 API 怎麼運作
每位玩家在 elite 有一個遊戲錢包：您的系統以 POST /wallet/deposit 轉入、POST /wallet/withdraw 轉出。遊戲中下注時立即扣本金，派彩、結果修正與作廢自動入帳或退款，所以餘額永遠是可用餘額。
- 轉帳是單階段的：回應成功就是已經完成。
txnId是您的轉帳單號，也是冪等鍵。逾時後以同一個txnId、相同內容重送，或先查詢；絕對不要換新的txnId重送。- 金額是最多 4 位小數的十進位字串；玩家的幣別在建立時決定，之後不能變更。
典型的串接步驟
- 註冊：自動開通成對的沙箱租戶（測試幣），以及沙箱、正式兩把 API 金鑰（快速開始）。
- 第一個簽章呼叫：先試
GET /tables；簽章不符時，用簽章除錯器逐行比對（認證與簽章）。 - 啟動遊戲：由您的後端讓測試玩家進入遊戲（遊戲啟動）。
- 轉入與轉出：包含逾時後的重送（錢包（轉帳））。
- 注單同步：以
(slipId, rev)去重，寫入您的資料庫（注單同步）。 - Webhook：更快收到結算通知；正確性仍以
GET /bets為準（Webhook）。 - 上線：Console 的上線檢核清單以沙箱金鑰實際呼叫簽章、啟動、轉入、轉出與注單同步；通過後換成正式金鑰（主機不變）、設定 IP 白名單，再儲值升級正式方案。
沙箱、OpenAPI、Postman 與簽章除錯器
- 沙箱：不計費，最多 500 個測試玩家、每秒 20 次請求，也會送出 Webhook。
- OpenAPI 3.1 規格（YAML、JSON），也是 API 參考的來源。
- Postman 集合：中文說明與英文兩版，已內建簽章腳本。
- 簽章除錯器：在瀏覽器內逐步計算 API 與 Webhook 簽章，Secret 不會送出。
- 簽章範例：Node.js、PHP、C#、Java、Python、Go。
所有下載都在工具與下載。
限流
| 方案 | 每秒請求數 | 可短暫突發 |
|---|---|---|
| 正式方案 | 100 | 200 |
| 沙箱 | 20 | 40 |
| 免費展示方案 | 5 | 10 |
以租戶為單位計算；超過時回 429 RATE_LIMITED，請退避後以新的 nonce 重試。注單請以游標每頁最多 1,000 筆批次讀取，不要逐筆查詢。見限流與配額。
不必開發：自己網域的白牌登入網站
想以真人視訊白牌的方式上線、又沒有開發人力時：
- 在 Console 建立玩家帳號，額度也在 Console 上下分。
- 以 CNAME 把自己的網域（例如
play.yourbrand.com）指向 elite。 - 在 品牌與登入 → 自訂網站 從四種版型挑一種；遊戲大廳、桌內與讀取畫面換成您的 Logo，玩家也可以把網站加入主畫面。
- 自訂網站是正式方案的功能。還沒有自己的網域時，玩家也可以從 elite 的公用登入頁進場。
也要開自己的桌？
如果牌桌也是您的，牌局結果另有一個介面：資料源介面 GFI，讓您自己的開牌系統以簽章推送牌局事件；也可以用荷官平板或 EWIN AI VISION。見真人百家樂系統、真人龍虎、德州撲克與牛牛與真人攝影棚架設指南。
常見問題
elite 用哪一種錢包？
轉帳錢包。您的系統以 API 把金額轉入、轉出玩家在 elite 的遊戲錢包，遊戲中的下注與派彩都在這個錢包內處理。
可以先測試再付費嗎？
可以。沙箱不計費；免費展示方案也可以先體驗完整流程，準備好再儲值升級。
遊戲可以嵌進我的網站嗎？
可以。把啟動網址設成 iframe 的 src（保留 allow="autoplay; fullscreen"），或直接導向。遊戲不使用 Cookie，在第三方 iframe 也能運作；手機上建議整頁導向。
新遊戲上線要重新串接嗎？
不用。所有遊戲共用同一套啟動、錢包、注單與 Webhook API，注單只依遊戲多幾個欄位，例如牛牛的預扣、德州撲克的抽水。
平台會抽成嗎？
不會。費用只有按日計算的每月桌費與依 GB 計的串流費，從預付額度扣，見官網價格區。
今天就開始串接。 免費註冊，幾分鐘內就能拿到 Console 與 API 金鑰，或到 elite 平台總覽與 elite 官網 了解更多。