#PetaX 游戏集成指南

文档版本：1.5.0

本文档提供了将PetaX的网页游戏集成到商户平台的综合指南。 PetaX 专注于开发引人入胜的网络游戏，而商户则充当托管网站，用户可以在其中发现和访问这些游戏。当用户点击商户提供的游戏链接时，他们会被重定向到PetaX 的URL 进行游戏。两个系统之间的通信和身份验证通过后端APIs 和RabbitMQ 进行实时消息传递。

本指南概述了确保无缝集成的必要步骤、技术要求、API 详细信息和最佳实践。它适用于商户的开发人员和技术团队。

#架构概述

#可用环境

PetaX提供的环境：staging、production。

PetaX与商户集成、运行、数据通信时的环境必须匹配。

#步骤

#注册商户

联系PetaX进行商户注册。

#收集所有PetaX 连接信息

连接信息将由PetaX提供。完整列表可在此处获取。

#设置基础设施

将 PetaX 提供的所有 IP 和域列入白名单。

#提供商户连接信息

将以下信息发送至PetaX：

用于白名单的商户服务的 IP 和域列表。
MERCHANT_API_BASE_URL：根URL，用于从PetaX 调用API。

#设置并测试 REST APIs

对于单一钱包模式：实施单一钱包API以接收来自PetaX的数据。
转账钱包模式：调用 PetaX 提供的转账钱包 API与转账钱包系统进行交互。
当收到来自PetaX的API电话时，请仔细核实。请遵循本指南。
调用 PetaX APIs 时，请将提供的 JSON Web 令牌包含在请求标头 Authorization 中，并带有 Bearer 前缀。
遵循API错误处理指南。

#（可选）设置并测试 RabbitMQ

请参阅 RabbitMQ 指南了解可用功能和集成方法。

#在 Website 上设置游戏

遵循 PetaX 身份系统，以在网络、iOS、Android、4K 显示器和移动主屏幕上保持一致的易读性。

游戏技术实现请参见玩游戏 URL 及参数。

请参阅结果Website了解嵌入游戏结果、期号日志和注单日志页面。