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 开始并包含查询字符串。

响应格式

{ "ok": true, "data": { … } }

{ "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

下载

• OpenAPI 3.1 规格（YAML）
• OpenAPI 3.1 规格（JSON）
• Postman 集合（v2.1，已内置签名脚本）

导入后在集合的 Variables 填入 apiKey 与 apiSecret（沙箱密钥），每个请求送出前会自动计算签名。