Hive 伺服器 API 參考¶
本指南說明了使用 Hive 平台所需的 Hive 伺服器 API；Auth v4 令牌驗證 API 和 IAP v4 收據驗證 API，並概述了如何實現 項目。
必需的 server API¶
Auth v4 令牌驗證¶
● API 指南: Auth v4 令牌驗證
令牌驗證 API 會驗證用戶端登入成功後回傳的令牌真實性，並回傳驗證結果。 如果遊戲不允許重複登入，必須實作保存已登入使用者令牌並使上一次登入中使用的令牌失效的功能，例如登出或結束遊戲工作階段。 認證會透過基於 OAuth 2.0 的使用者令牌方式執行，遊戲伺服器透過 X-Access-Token 標頭執行玩家認證。所有回應都會包含 token_validation 欄位，以提供詳細的 JWT 驗證結果。
IAP v4 收據驗證¶
● API 指南: IAP v4 驗證收據
收據驗證 API 對應用內購買的收據進行驗證，然後回應驗證結果，以確定收據是否正常處理。請參考下面的圖表以了解更多有關 IAP v4 的購買過程。 
在將物品交付給在遊戲中支付物品的用戶之前，必須向 Hive 伺服器請求驗證來自遊戲伺服器的收據。此外，您可以根據收據驗證的回應 hiveiap_transaction_id 和 hiveiap_market_pid 來判斷是否交付物品。
| 字段名称 | 描述 | 类型 | 是否必填 |
| hiveiap_transaction_id | 由收据成功验证生成的交易 ID。此值保存在游戏服务器中以检查重复收据。 仅在响应代码为 0（验证成功）时交付 | 字符串 | N |
| hiveiap_market_id | 区分用户支付的商店的市场代码。 1: 苹果应用商店 2: 谷歌 Play 商店 3: Lebi 4: ONE 商店 仅在响应代码为 0（验证成功）时交付 | 整数 | N |
hiveiap_transaction_id是成功驗證的收據的唯一鍵，該收據已發出。 為了避免重複收據，該值在交付物品時保存在遊戲伺服器中，然後您可以決定收據是否已被使用。收據驗證是 Hive 伺服器退還價值的唯一依據。此外，Hive 伺服器無法區分收據是在購買嘗試後驗證的還是因為未能發送物品而進行的恢復操作。hiveiap_market_pid是從收據或收據的驗證結果中提取的物品信息。通過客戶端發送的物品信息存在記憶體轉換的風險，因此您必須根據此值決定並交付物品。
項目¶
item 是一個系統，用於整合和管理遊戲中遊戲貨幣和物品的交付和檢索功能。通過 item，您可以連接各種系統，例如優惠券系統、活動、提供牆和 CPI 來發送或檢索物品，並且管理員的後台可用於手動查詢發送和檢索物品的歷史記錄。
Item的结构是，如果Item Server调用send item API或retrieve item API到游戏服务器，游戏服务器会对请求做出响应。有关Server API的更多详细信息，请 前往 API > Hive Server API > Billing > Sync with Item 在Hive Developers上。