IAP v4 アイテム配信結果の送信

アイテム配信結果の送信は、IAP v4を通じてアイテムを購入したユーザーにアイテム配信の結果を送信します。このAPIを実装する場合、IAPシステムは、返金ポリシーを悪用するユーザーを制限するために必要なマーケット無効購入リストのアイテム配信のステータスを送信します。

  • リクエスト URL
    共通URL https://hiveiap.qpyou.cn/api_v4/item_result
    サンドボックスURL https://sandbox-hiveiap.qpyou.cn/api_v4/item_result
    HTTPメソッド POST
    コンテンツタイプ text/HTML;charset=utf-8
    データ形式 JSON
フィールド タイプ 説明 必須
hiveiap_transaction_id 文字列 IAP v4 レシート検証 によって応答された hiveiap_transaction_id の値を送信します Y
result_status 整数 アイテムの配信が成功したかどうか
0: 配信失敗
1: 配信成功		 Y
user_id_type 文字列 Hive SDK ユーザータイプ
v0: C2S モジュール (uid)
v1: Auth v1 (vid)
v4: Auth v4 (player_id)		 Y
user_id 文字列 ユーザー ID
user_id_type が v0 の場合は uid を送信; v1 の場合は vid を送信; v4 の場合は player_id を送信		 Y
asset 配列 配信されたアイテムデータ
配信成功の場合は値を送信し、配信失敗の場合は空の配列 ([]) を応答します		 N
asset_id 文字列 アイテム ID N
asset_name 文字列 アイテム名 N
quantity 整数 配信されたアイテムの数 N
game_payload_info オブジェクト Hibe Analytics の追加インデックスとして使用するためにゲームサーバーから受信した値 N
  • サンプルコード
    • 呼び出す 
      curl -L -v -d '{"hiveiap_transaction_id": "GO_22160", "result_status": 1, "user_id_type": "v4", "user_id": 30000041527, "asset ": [ {"asset_id":"item_1","asset_name":"item_1_name","quantity":1},{"asset_id":"item_2","asset_name":"item_2_name","quantity":1} ], "game_payload_info": {"gifteeid":null,"chracter_type_id":0,"product_name":"Cookingdom Alternative Store Pack 1"}}' -H "Content-Type: text/html" https://sandbox -hiveiap.qpyou.cn/api_v4/item_result
    • リクエスト 
       POST /api_v4/item_result HTTP/2
> Host: sandbox-hiveiap.qpyou.cn
> user-agent: curl/7.68.0
> accept: /
> content-type: text/html
> content-length: 235
    • 応答 
      < HTTP/2 200
< server: nginx
< date: Wed, 23 Mar 2022 08:20:44 GMT
< content-type: text/html; charset=utf-8
{"result":0,"result_msg":"success"}