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

アイテム配信結果送信APIは、Hive IAP v4を通じて消費財を購入したユーザーにアイテム配信の結果を送信するAPIです。このAPIを実装することで、Hive 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		文字列	Hive IAP v4 レシート検証から返されたhiveiap_transaction_idの値を送信します	Y
result_status		整数	アイテムが正常に付与されたかどうか 0: 付与失敗 1: 付与成功	Y
user_id_type		文字列	Hive ユーザータイプ（固定値`player_id`を使用）	Y
user_id		文字列	Hive ユーザーID（`player_id`）	Y
asset		配列	付与されたアイテムに関する情報付与が成功した場合のみ値を送信し、付与が失敗した場合は空の配列（[]）で応答します	N
	asset_id	文字列	アイテムID	N
	asset_name	文字列	アイテム名	N
	quantity	整数	付与されたアイテムの数	N
game_payload_info		オブジェクト	Hive アナリティクスの追加メトリクスのためにゲームサーバーから受信した値	N

例のコード¶

呼び出し¶

curl -L -v -d '{"hiveiap_transaction_id": "GO_22160", "result_status": 1, "user_id_type": "player_id", "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":"Cooking Kingdom 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"}