接入指南
开放娱乐平台提供两种接入方式：API 自建与平台托管。介绍首页用于了解产品；进入控制台后，在「接入应用」管理应用与接入申请，在「消息收件箱」查看审核和账号通知。
先选择接入方式
| 接入方式 | 适合的团队 | 需要准备 | 开通后在哪里管理 |
|---|---|---|---|
| API 自建 | 自己维护站点、玩家系统与钱包 | 服务端、数据库、出口 IP 与回调接口 | 开放平台维护接入配置，自有系统管理运营 |
| 平台托管 | 希望使用统一服务器、无需单独部署 | 商户名称、公司／团队与联系方式 | 开放平台管理申请，商户后台管理站点与运营 |
每个应用只需提交一套接入申请。创建开发者账号或应用不代表已获准接入；托管商户还需完成系统开通。
平台托管
- 创建开发者账号，点击「创建托管商户」，提交资料及接入申请。
- 等待审核；审核通过后由系统自动开通。
- 开通完成后，在应用详情访问商户站点或进入商户后台。
- 设置商户 Logo、专属访问链接或自有域名，按权限管理玩家与运营。
无需自行部署服务器，不需要手动管理 API 凭据。
API 自建：使用标准模板
模板已包含玩家账号、游戏列表、启动游戏、钱包和统一回调处理。
- 下载模板，按包内 site/docs/deployment.md 部署独立站点与数据库。
- 点击「创建 API 自建应用」，申请接入，登记服务器出口 IP 和完整回调地址。
- 将审核通过后的接口地址、code、secret 填入模板后台「游戏接入配置」。
- 使用专用测试玩家验证游戏、回调、结算和退出。
API 自建：自行开发
适合已有玩家系统和钱包、需要自行实现游戏入口与回调的团队。接口由你的服务器调用，浏览器只打开返回的游戏链接。
- 创建 API 自建应用并申请接入。
- 在服务端完成签名认证，获取 token。
- 查询游戏目录，获取玩家的游戏启动链接。
- 实现统一回调与幂等处理，完成联调。
联调与正式准入
接口认证成功和游戏画面可打开，只表示接入链路可用。开放运营前还需验证实际对局、结算、重复回调和异常退出。已落库回调支持失败重试，消息落库前的崩溃仍需人工核对，详见回调与结算。