API 參考
elite 租戶整合 API · v1.0.0
租戶（營運商）後端呼叫的整合 API：啟動玩家遊戲、轉帳錢包、注單同步、桌檯與局結果、帳務查詢。
- 只能由伺服器呼叫：每個請求都以 API 金鑰的 Secret 做 HMAC-SHA256 簽章，Secret 絕不可放在瀏覽器或 App。
- 回應格式：成功
{"ok": true, "data": {…}}；失敗{"ok": false, "error": {"code": "…", "message": "…"}}，HTTP 狀態碼有意義。 - 金額一律是十進位字串：玩家金額最多 4 位小數（例如
"100"、"0.95"），帳務金額（USD）最多 6 位小數。 - 時間：回應中的時間是 UTC ISO-8601（例如
2026-09-24T03:00:00.000Z）。 - 沙箱與正式：沙箱金鑰（
ek_s_…）連到成對的沙箱租戶（測試幣、模擬器桌），正式金鑰（ek_l_…）連到正式租戶；兩者使用同一個主機與同一套 API。
伺服器
| 環境 | Base URL |
|---|---|
| 正式環境（沙箱金鑰與正式金鑰都使用這個主機） | https://elite.ewin888.com/api/tenant/v1 |
| 測試環境（獨立部署；帳號、金鑰與資料都和正式環境分開） | https://elite-dev.ewin888.com/api/tenant/v1 |
認證
每個請求都要帶下列標頭，簽章規則見認證與簽章。
| 標頭 | 說明 |
|---|---|
X-Api-Key | 金鑰 ID，格式 ek_<s|l>_<租戶代號>_<16 碼>（s 沙箱、l 正式），例如 ek_s_1a_XXXXXXXXXXXXXXXX。在 Console「上線與串接 → API 金鑰」取得。 |
X-Timestamp | 目前的 Unix 時間（秒，9–11 位數字）。與伺服器時間差超過 ±300 秒會被拒絕。 |
X-Nonce | 每個請求都不同的隨機字串，16–64 個英數字；10 分鐘內不可重複使用（重試也要換新的 nonce）。 |
X-Signature | hex(HMAC-SHA256(secret, METHOD + "\n" + PATH_AND_QUERY + "\n" + X-Timestamp + "\n" + X-Nonce + "\n" + hex(SHA256(body))))。PATH_AND_QUERY 從 /api/tenant/v1 開始並包含查詢字串。 |
回應格式
json
{ "ok": true, "data": { … } }json
{ "ok": false, "error": { "code": "INSUFFICIENT_BALANCE", "message": "insufficient available balance" } }端點一覽
玩家
| 方法 | 路徑 | 說明 |
|---|---|---|
| POST | /player/launch | 啟動遊戲 |
| POST | /player/logout | 登出玩家 |
| GET | /player | 查詢玩家 |
| POST | /player/update | 更新玩家 |
錢包（轉帳）
| 方法 | 路徑 | 說明 |
|---|---|---|
| POST | /wallet/deposit | 轉入（加點） |
| POST | /wallet/withdraw | 轉出（扣點） |
| GET | /wallet/transfer | 查詢轉帳 |
| GET | /wallet/balance | 查詢餘額 |
注單
| 方法 | 路徑 | 說明 |
|---|---|---|
| GET | /bets | 注單增量同步 |
| GET | /bets/summary | 每日每玩家彙總 |
桌檯與局
| 方法 | 路徑 | 說明 |
|---|---|---|
| GET | /rounds/{roundId} | 查詢局結果 |
| GET | /tables | 桌檯清單 |
| POST | /tables/enable | 啟用桌檯 |
| POST | /tables/disable | 停用桌檯 |
帳務
| 方法 | 路徑 | 說明 |
|---|---|---|
| GET | /account | 帳戶摘要 |
| GET | /account/usage | 每日用量 |
| GET | /account/statements | 月結單 |
Webhook 事件
本平台送到你的伺服器的事件。簽章、重試與冪等處理見 Webhook。
| 事件 | 說明 | data |
|---|---|---|
bet.settled | 局結算 | RoundEventData |
round.corrected | 結果修正後重算 | RoundEventData |
round.voided | 局作廢 | RoundEventData |
player.kicked | 玩家被踢出 | PlayerKickedData |
account.grace | 進入寬限期 | AccountStateData |
account.downgraded | 自動降級 | AccountStateData |
account.restored | 恢復付費方案 | AccountStateData |
account.topup | 儲值入帳 | AccountTopupData |
account.low_balance | 預付額度偏低 | AccountLowBalanceData |
test | 測試事件 | TestEventData |
下載
匯入後在集合的 Variables 填入 apiKey 與 apiSecret（沙箱金鑰），每個請求送出前會自動計算簽章。