娱乐场游戏聚合API：整体是如何搭建的

API的整体结构

您这一侧的请求全部以JSON POST正文的形式发送到同一个端点。每个请求都携带您的登录名、密码以及要调用的方法名，响应也以JSON返回。不同产品没有各自独立的基础URL，真人娱乐场或体育也没有第二套规范：一个igaming API覆盖40,000多款游戏的整个内容库以及sportsbook。

反方向——从我们到您——的流量就是seamless wallet：每当需要读取或变更玩家余额时，我们就调用您的服务器。这些回调以带签名的HTTP GET请求送达，参数放在查询字符串中。

您调用的方法

游戏列表

游戏列表是您游戏大厅的骨架。每个条目都有一个稳定的标识，您保存下来，启动时原样传回即可。游戏类型字段已经在各工作室之间统一标准化，您可以直接根据响应搭建“老虎机”“真人”“Crash”“桌面游戏”和“体育”栏目。真人桌台和sportsbook也只是这份列表中的条目。

启动

打开游戏时，您需要发送玩家、游戏标识、设备（桌面端或移动端）和玩家所在国家，语言为可选参数。您会收到一个在iframe中加载的URL。国家很重要：有些工作室排除特定市场，我们依据您发送的国家执行限制，绝不根据IP地址去猜测。每次真钱启动都请带上国家参数。

试玩

大约16,000款老虎机可以按同样的方式以试玩模式启动。无需玩家记录，也不会触发回调，因此试玩启动可以放心用在公开页面上。

Seamless wallet回调

玩家资金从不离开您的平台。我们会向您的回调URL发送三种操作：

• balance：读取玩家当前余额，通常在会话开启时调用。
• debit：一笔投注。扣除金额并返回新余额，或返回余额不足错误码及当前余额。
• credit：一笔派彩。加上金额并返回新余额。

每次调用都带有唯一的交易ID、对局ID和游戏标识。金额以该货币最小单位的整数表示。您的端点始终返回HTTP 200；处理结果以错误码的形式放在JSON正文中：成功、余额不足或处理错误。

回滚

回滚不是单独的操作。它以带有回滚标记的debit或credit形式送达，您像处理其他资金变动一样处理即可。保证安全的关键是按交易ID去重。

安全

每个回调都包含一个时间戳，以及由该时间戳和您的私有盐值生成的密钥。超出短时间窗口或密钥不匹配的请求一律拒绝。为了进一步加强防护，每个回调还带有一个基于全部参数计算的HMAC-SHA256请求头，因此金额或用户名一旦被篡改，校验就会失败。

免费旋转与免费回合

两种不同的东西共用这个名字，值得说清楚。

游戏内免费旋转在整个内容库中都能直接使用，无需任何开发。Scatter触发的免费旋转、奖励回合、Feature Buy和奖池都在游戏内部运行，奖金以普通credit的形式到达您这里，而且往往没有对应的debit。您的处理程序必须接受这类credit。

促销免费回合，即您作为欢迎优惠发给玩家的那种，在我们这里不是可自助调用的API。如果您的红利方案依赖发放免费回合，请在开发之前联系我们，我们会告诉您针对您考虑的游戏可以如何安排。

货币

货币按玩家设置。一个账户可以服务使用多种货币的玩家，也可以把某个网站锁定为一种货币。主要的多工作室老虎机系列和sportsbook支持38种ISO货币，包括EUR、USD、GBP、CAD、AUD、BRL、MXN、ARS、INR、BDT、PKR、IDR、PHP、THB、VND、TRY、ZAR和ETB。其他系列会因工作室不同而增减货币，因此请以货币方法的返回结果为准，而不是任何宣传册。

同一个API接入体育博彩

我们内容库中的sportsbook——Nocturn Sport——用与老虎机相同的调用启动，并通过同样的三种回调结算。赛前和滚球投注在下注时扣款、在结算时派彩；对于冠军盘这类投注，结算可能在数小时甚至数天之后。CS2、Dota 2、Valorant等电竞项目与足球、网球、篮球并列。我们在sportsbook GGR中的分成比例为12%。体育相关细节请见体育博彩API页面。

多品牌配置

运营多个网站的运营商无需重复对接。每个新增品牌都在同一账户下获得独立的凭证和回调URL；如果您的牌照有要求，各网站的内容库也可以不同。

下一步

按照娱乐场API快速对接中的步骤顺序操作，在价格页面查看费用，或在API密钥页面申请凭证。如果您正在评估多家聚合商，对比中心并列展示了每家如何在文档中说明其钱包机制。