真人视讯 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 官网 了解更多。