跳转至

IAP v4 传输商品配送结果

物品交付结果传输API是一个将物品交付结果发送给通过Hive IAP v4购买消费品的用户的API。通过实现此API,Hive IAP系统将代表市场退款和取消列表发送物品交付状态,这对于制裁滥用退款的用户至关重要。

请求 URL

商业网址 https://hiveiap.qpyou.cn/api_v4/item_result
沙盒网址 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"}