Skip to main content

快速接入指南

为了快速接入游戏系统，接入方只需实现 进入游戏接口 与 三方回调接口 即可完成基础接入。

1. 业务流程概述​

  1. 进入游戏

    • 接入方调用进入游戏接口
    • 接口返回游戏的 URL 地址
    • 玩家通过该 URL 进入游戏

  2. 三方回调

    • 游戏内部调用接入方实现的三方回调接口
    • 接口调用失败时，系统会 最大重试 5 次
    • 目前需要实现的三方回调接口有三个：
      1. 查询余额接口：用于获取玩家当前余额
      2. 投注结算接口：用于提交玩家投注信息并结算
      3. 干预接口：用于在玩家中奖时调整结果，以干预结果为准

2. 注意事项​

  • 干预接口调用时机：仅在玩家中奖情况下触发，返回的干预结果将覆盖游戏的原始中奖结果。
  • 重试机制：若接口调用失败，系统会自动重试最多 5 次，确保可靠性。
  • 接口优先级：干预接口 > 投注结算接口 > 查询余额接口，即干预结果最终决定玩家结算结果。

3. 接入步骤​

  1. 实现进入游戏接口

    • 接收请求并返回游戏 URL
    • 确保 URL 可直接访问游戏页面

  2. 实现三方回调接口

    • 查询余额：返回玩家钱包余额
    • 投注结算：提交玩家投注并返回结算结果
    • 干预接口：在中奖情况下调用，返回干预后的结算结果

  3. 测试接口

    • 模拟玩家进入游戏、投注及中奖场景
    • 确认三方回调接口能正确返回结果且重试机制生效

4. 接入流程图​

flowchart TD
    A[玩家请求进入游戏] --> B[进入游戏接口返回 URL]
    B --> C[玩家通过 URL 进入游戏]
    C --> D[游戏调用三方回调接口]
    
    D --> E[查询余额接口]
    D --> F[投注结算接口]
    D --> G[干预接口（中奖时调用）]

    E --> H{返回余额结果}
    F --> I{返回结算结果}
    G --> J{返回干预结果（覆盖结算）}

    H --> K[玩家看到余额]
    I --> K
    J --> K