跳轉至

Hive 伺服器 API 參考

本指南說明了使用 Hive 平台所需的 Hive 伺服器 API;Auth v4 令牌驗證 APIIAP v4 收據驗證 API,並概述了如何實現 項目

必需的 server API

Auth v4 令牌驗證

●  API 指南: 驗證身份驗證 v4 令牌

令牌驗證API通過驗證遊戲客戶端在成功登錄後返回的令牌驗證來響應。 如果遊戲不允許重複登錄,您必須保存已登錄用戶的令牌,並實現使先前登錄中使用的令牌失效的功能,例如登出或遊戲終止。 令牌驗證服務器為與海外服務器的差連接提供分佈式環境。如果令牌驗證未通過通用URL響應,您應該實現通過分佈式環境URL重新請求驗證的功能。

IAP v4 收據驗證

●  API 指南: IAP v4 驗證收據

收據驗證 API 對應用內購買的收據進行驗證,然後回應驗證結果,以確定收據是否正常處理。請參考下面的圖表以了解更多有關 IAP v4 的購買過程。

在將物品交付給在遊戲中支付物品的用戶之前,必須向 Hive 伺服器請求驗證來自遊戲伺服器的收據。此外,您可以根據收據驗證的回應 hiveiap_transaction_idhiveiap_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上。

Note

確保在 Hive 控制台的 項目管理 菜單中註冊遊戲伺服器 URL 和項目,以便與之同步。 有關項目管理的更多信息,請參閱 操作 > 計費 > Hive 開發者的 項目管理 頁面。