簡介與核心概念
本站面向運營商——也就是擁有玩家、並從 moose-platform 目錄中嵌入遊戲的博彩網站/應用。除了作為運營商所需的背景知識之外，本站不涉及廠商側的內容。
一次整合，覆蓋所有遊戲
你不需要單獨對接每一家遊戲廠商。你只需要與 moose-platform 整合一次，此後任何廠商發佈到平台上的遊戲，都能以同樣的方式啟動：一次已簽名的 API 呼叫、一套錢包回調契約、一套 shell 端訊息協議——無論這個遊戲是哪家廠商開發的。
你會接觸到的三個介面層
你的整合由三個相互獨立的部分組成。它們容易被混為一談，因為都是在「你這一側」和「平台」之間搬運資料，但每一部分的呼叫方、傳輸方式和信任模型都不一樣：
| 介面層 | 傳輸方式 | 誰簽名 | 範例 |
|---|---|---|---|
| 運營商 API（你 → 平台） | 已簽名的 HTTP，由你發起呼叫 | 你 | 啟動一個 session、列出你的遊戲目錄、踢出玩家、鑄造回放連結 |
| 錢包回調 API（平台 → 你） | 已簽名的 HTTP，由平台發起呼叫 | 平台（你負責驗證） | 結算一筆 BET/WIN/ROLLBACK、回答餘額查詢 |
| 遊戲 → shell 橋接 | 瀏覽器 postMessage，單向 | 不適用（透過 envelope 與 origin 校驗建立同瀏覽器信任） | 遊戲生命週期事件上報給你的嵌入頁面 |
前兩者在兩個方向上共用同一套 HMAC 機制——見簽名與身份驗證。第三者則和簽名完全無關：它是遊戲 iframe 與你的頁面之間的同瀏覽器訊息，靠 origin 和 envelope 標記校驗，而不是密碼學簽名——見Shell 端橋接。
沒有客戶端 SDK，以及原因
運營商這一側沒有 SDK。每個運營商用來搭建自己網站的技術棧都不一樣，而你需要做的兩件事——簽名一個 HTTP 請求、驗證一個 HTTP 請求——用任何 HMAC-SHA256 原語都只需要幾行程式碼就能完成。正因如此，本站每個程式碼範例都是自包含的：把它複製進你自己的技術棧即可，不需要為此額外引入依賴。
moose-platform 從不持有資金
這是需要牢記在心的最重要一點：moose-platform 是一個無縫錢包（seamless-wallet）聚合平台。它從不託管玩家的資金。你自己的錢包才是玩家餘額的唯一真相來源——平台的職責是即時、按序、恰好一次地把每一筆下注和派彩路由到你的錢包。這正是錢包回調 API存在的意義，也是這次整合裡最值得投入心力的部分。
核心不變量
以下規則在雙向的每個介面上都成立——在深入各篇指南之前，值得先把它們牢記在心：
- 金額永遠是該幣別最小單位的整數（例如
USD的分）——絕不是浮點數。500代表 $5.00。currency永遠是大寫三字母的 ISO-4217 代碼。 - 身份永遠不會從請求體裡取得信任。 你的運營商身份來自你的簽名；玩家的身份來自
playerRef/sessionToken，並在伺服端針對你自己呼叫launchGame所建立的 session 做解析。 - 冪等性永遠由呼叫方自行產生的 ID 來鍵定：錢包呼叫用
transactionId，免費旋轉用requestRef/idempotencyKey。收到重試的一方必須用第一次給出的同一個回應來回答，而不是重新套用一次效果。 WIN是和它的BET相互獨立的一筆交易，不是同一個請求上的一個欄位。這兩者裡無論哪一個結束了這一局，都會帶上roundComplete: true。
完整的欄位級參考見資料模型與列舉。