#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以了解嵌入遊戲結果、期號日誌和注單日誌頁面。