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"}