娱乐场API快速对接：按顺序列出每一步

对接时间究竟花在哪里

问开发人员接入一家游戏聚合平台要多久，答案是“几天”。问运营商从第一封邮件到第一笔真实投注用了多久，答案往往是好几周。差别就在于开发人员碰到API之前发生的一切：需求沟通会、方案报价、合同草稿来回修改、一笔必须先到账的对接费，然后是沙盒密钥，再然后还要单独申请生产环境密钥。

我们砍掉了这些前置环节。您在申请之前就能阅读我们的文档，没有合同谈判，获取访问权限之前也无需付费。账户审核通过后，凭证和测试额度就在您的后台里，而且测试额度直接在正式API上可用，所以之后也不存在从沙盒切换到生产环境这一步。

开始之前：您这一侧需要准备什么

• 玩家钱包。我们的API是seamless wallet模式：余额保存在您的平台上。如果您已经有钱包，基本上就完成了大半。如果没有，请先自建或采购一个，这一步任何聚合平台都无法替您缩短。
• 一个公网HTTPS端点，能够接收我们的钱包回调并快速响应。
• 玩家货币清单以及您要服务的国家，因为两者都会影响哪些游戏可以启动。

第1步：获取凭证

在API密钥页面申请访问权限。审核通过后，您可以在运营商后台找到登录名、密码和私有盐值。设置好我们发送钱包回调的URL，这就是开始所需的唯一配置。

第2步：确认货币

先调用货币方法，再做其他事。它会告诉您账户已开通哪些玩家货币。跳过这一步，是启动失败却找不到明显原因的最常见情况：玩家创建时使用的货币，游戏并不接受。

第3步：拉取内容库

请求游戏列表。每款游戏都带有稳定的标识、缩略图、所属工作室和标准化的游戏类型。请根据类型字段（老虎机、真人、Crash、桌面游戏、体育）搭建大厅栏目，而不要依赖各工作室风格不一的标签。保存好这些标识，启动游戏时需要原样传回。

第4步：创建测试玩家

用用户名和货币注册一名玩家。此后该玩家的货币就固定不变，所以请慎重选择。

第5步：编写回调处理程序

这是唯一需要认真对待的部分。我们会以三种操作调用您的端点：

1. 会话开启时的balance，
2. 每笔投注的debit，
3. 每笔派彩的credit。

每次调用都请返回HTTP 200，JSON正文中包含新余额，金额以最小单位的整数表示（2.50写作250）。余额不足等问题请通过正文中的错误码报告，而不是返回HTTP错误。对每个请求校验签名，并按交易ID去重，确保重试的调用绝不会让资金变动两次。

两条规则可以避免大部分客服工单。第一，永远不要因为不认识type字段就拒绝回调，请按action来处理。第二，接受没有对应debit的credit。游戏内免费旋转、奖励回合和奖池恰恰就是这样派彩的，拒绝它们的处理程序会让玩家拿不到钱。回滚带有标记送达，按普通的debit或credit处理即可。

第6步：启动游戏

为一款老虎机请求启动URL，发送玩家、游戏标识、设备类型和玩家所在国家。在iframe中打开URL，用测试额度转几把，观察debit和credit到达您的端点。然后查看该玩家的对局历史，确认投注和派彩与您账本的记录一致。

现实的时间表

对于已经运营钱包的团队，第2到第6步一个工作日就能完成；第一天跑通第一局真实游戏是切实可行的目标。要把它变成一个生产环境的游戏大厅——包含完整内容库、真人娱乐场、体育、移动端启动、多语言和试玩模式——通常需要大约一周。没有钱包的团队，还需要再加上自建钱包所需的时间。

增加真人娱乐场或sportsbook并不会让项目从头再来。两者都出现在同一份游戏列表中，用同一个启动调用打开，通过相同的回调结算，因此只是前端工作。我们的体育博彩API页面说明了少数几个体育特有的要点，比如下注很久之后才结算的投注。

正式上线

测试完成后，充值预付额度（单次充值最低100 USD），向真实玩家开放。真钱对局结算时，佣金从该额度中扣除。运营不止一个品牌？每个额外网站都在同一账户下获得独立的凭证和回调URL，无需重新对接。

完整的方法和字段列表，请见娱乐场游戏聚合API概览。费用方面，请见价格页面以及免费娱乐场API说明。如需在同等条件下比较各供应商的接入速度，请使用对比中心。