Hive サーバーAPIリファレンス¶
このガイドでは、Hive プラットフォームを使用するために必要な Hive サーバーAPI、Auth v4 トークン検証 API および IAP v4 レシート検証 API について説明し、アイテムの実装方法を概説します。
必要な server API¶
Auth v4 トークン検証¶
● API ガイド: 認証 v4 トークンの検証
トークン検証APIは、成功したログイン後にゲームクライアントから返されたトークン検証を確認することで応答します。 ゲームが重複ログインを許可しない場合、ログインしたユーザーのトークンを保存し、前回のログインで使用されたトークンの無効化を実装する必要があります。たとえば、ログアウトやゲーム終了などです。 トークン検証サーバーは、海外サーバーとの接続が不安定な分散環境に対応しています。トークン検証が共通のURLを介して応答しない場合、分散環境のURLを通じて再度検証を要求する機能を実装する必要があります。
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: Apple App Store 2: Google Play Store 3: Lebi 4: ONE store レスポンスコードが0（検証成功）の場合のみ配信されます。 | 整数 | N |
hiveiap_transaction_idは、発行されたレシートが正常に検証されたユニークキーです。 レシートが重複しないように、アイテムを配信する際にゲームサーバーに値が保存され、その後、レシートが使用されたかどうかを判断できます。レシートの検証は、Hive サーバーによって値を返す唯一の基準です。さらに、Hive サーバーは、レシートが購入試行後に検証されたのか、アイテム送信の失敗による復元アクションによって検証されたのかを区別することはできません。hiveiap_market_pidは、レシートから抽出されたアイテム情報またはレシートの検証結果です。クライアントを通じて送信されるアイテム情報は、メモリ変換の危険があるため、この値に基づいてアイテムを決定し、配信する必要があります。
アイテム¶
itemは、ゲーム内のゲームマネーやアイテムの配信および取得機能を統合・管理するシステムです。 itemを使用することで、クーポンシステム、イベント、オファーウォール、CPIなどの多様なシステムと接続してアイテムを送信または取得することができ、管理者用のバックオフィスでは、アイテムの送信および取得の履歴を手動で検索することができます。
Itemの構造は、Item Serverがゲームサーバーにsend item APIまたはretrieve item APIを呼び出す場合、ゲームサーバーがリクエストに応答するというものです。Server APIの詳細については、go to API > Hive Server API > Billing > Sync with Item on Hive Developersをご覧ください。