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