Skip to content

README.zh-CN.md

Latest commit

 

History

History
132 lines (91 loc) · 7.39 KB

README.zh-CN.md

File metadata and controls

132 lines (91 loc) · 7.39 KB
Raw

AG Game Slots API 接入指南

官方网站： https://aggameapi.com/

10 Years. 1 API. 1,200+ Games. More Control.

Flexible API solutions built for slot platforms worldwide.

十年打磨，致力于为全球Slot平台提供更高效、灵活的API解决方案。

AG 专注于服务全球 Slot 平台，通过一套 API 连接经项目确认的 1,200+ 款 Slot 游戏，以及游戏启动、钱包接入、记录查询和项目级运营配置能力。

本仓库面向正在评估 AG Game Slots API 接入的平台、技术和运营团队，公开说明公司与业务定位、项目范围、主要技术决策和上线前应验证的事项。

本指南与官方 API 文档配合使用，补充公司定位、解决方案架构、实施规划和运营实践。

公开指南基线：AG Game API V5.0.0

最后复核：2026-08-16

关于 AG

AG 为具有多内容、多钱包和多地区需求的 Slot 平台提供 B2B API 解决方案。十年持续打磨形成一套统一接入路径，帮助平台减少重复集成，并对内容范围、钱包架构、RTP 配置、记录核对和多地区上线规划拥有更清晰的控制能力。

当前业务能力包括：

  • **1 套 API，1,200+ 款 Slot 游戏：**通过统一接入组织经项目确认的游戏内容，减少逐一维护不同技术路径的工作；
  • **RTP 灵活可调：**针对适用的游戏与版本，按项目方案和目标市场要求提供项目级 RTP 配置能力；
  • **两种钱包模式：**根据平台架构支持单一钱包和转账钱包两种接入方向；
  • **支持全球 35 个国家和地区：**围绕已公布的覆盖清单提供项目评估与 API 接入支持；
  • **全球低延迟访问：**通过全球分布式访问架构缩短区域访问链路，支持跨地区稳定使用；
  • **更高运营控制力：**把游戏会话、钱包事件、交易记录、记录核对和项目配置纳入一条交付流程。

项目启动阶段会结合游戏版本、部署区域和网络条件，确认游戏范围、RTP 配置、访问节点、语言、币种及多地区交付方案。

完整介绍见 AG 公司介绍、业务介绍和全球 35 个国家与地区。

业务能力概览

方向 AG 提供什么 为平台带来的价值
内容聚合 一套 API 接入经确认的 1,200+ 款 Slot 游戏 减少重复内容接入工作
平台集成 游戏目录、会话启动、钱包、商户与记录流程 用一套集成模型连接核心技术路径
运营配置 在适用游戏和项目范围内提供 RTP 灵活配置 为获准项目团队提供更清晰的运营参数控制
钱包架构 单一钱包与转账钱包方向 适配平台现有余额与账本模型
全球服务 支持 35 个国家和地区，并采用全球低延迟访问设计 为多地区项目缩短访问路径并准备落地范围
技术交付 范围确认、联调准备、测试、核对与上线支持 把 API 接入转化为可验收的实际项目

一套 API 接入 11 家游戏厂商

AG Slots API 当前整合以下 11 家游戏厂商：

PGSoft · Pragmatic · Evoplay · CP Games · WG Games · JILI · TADA · JDB · FC · BG · HSD

厂商发现、游戏列表和游戏会话启动通过一套接入流程完成。查看游戏厂商目录、完整的1,194 条游戏名称映射或结构化的游戏目录 JSON。

Slots API 接入通常覆盖什么

Slots API 接入把游戏启动、内容和运营连接成一条完整协作路径：

  • 获取双方确认的游戏厂商、分类和内容；
  • 创建玩家游戏会话并处理返回路径；
  • 选择并实现单一钱包或转账钱包；
  • 确保资金类请求在重试时只产生一次业务结果；
  • 查询游戏和钱包记录，用于支持与核对；
  • 验证超时、重试、回调和交易状态不确定等场景。

实际可用内容、币种、语言、市场、凭据和环境配置均属于项目级确认范围。

适合哪些团队

  • 评估接入与交付范围的平台或产品负责人；
  • 将 API 映射到现有玩家、会话和钱包架构的技术负责人；
  • 准备记录查询、差异核对和问题处理的运营团队；
  • 负责测试用例、责任分工、验收和上线准备的项目团队。

当前公开 API 范围

当前 V5.0.0 公开范围包含四组共 17 个 endpoint：

范围 主要用途 公开数量
游戏目录与会话 获取内容、创建游戏会话、结束玩家会话 5
单一钱包回调 协作处理余额、玩家、投注、结算和取消 5
转账钱包 转入、转出、余额、交易查询和资金恢复 5
记录与商户 查询游戏记录和商户配置 2

英文 Public API surface 列出了各 endpoint 能力和集成用途；官网还公开签名方法、代表性字段和脱敏示例，供技术评估。资金回收与商户配置两项高敏感能力的精确路径保留在受控实施资料，并与真实 Base URL、凭据、完整字段约束、最终回调清单和生产配置一并提供；公开内容不等于完整生产协议。

从集成方案开始

  1. 确认首批内容、币种、语言和目标市场范围。
  2. 梳理现有玩家身份、会话、钱包和账本责任。
  3. 根据现有架构选择钱包模式。
  4. 约定请求唯一性、重试、超时和核对规则。
  5. 在测试环境验证最短的游戏启动和钱包路径。
  6. 在生产批准前覆盖失败和恢复场景。

内容导航

主题文档当前以英文维护，中文主入口同步核心定位与导航。

安全实践

API 密钥、商户代码、Secret、白名单、生产主机、回调主机、玩家数据和真实交易记录应在指定的私有技术渠道中管理；签名密钥只能保存在受控服务端环境，不得进入浏览器代码、客户端包、日志、工单、聊天或公开 Issue。公开示例统一使用占位值。

生产接入前，应在最终项目协议中确认并测试时间戳与 nonce 防重放、商户级授权、频率与交易限制、幂等、未知结果核对和日志脱敏。本公开指南不表示服务端已经启用这些控制。

提交可能的泄露问题前请阅读 安全说明。

官方入口

项目启动阶段，AG 与平台团队会把所需厂商、游戏、币种、语言、钱包模式和目标地区整理为确认后的交付方案与技术测试范围。