ข้ามไปที่เนื้อหา

IAP v4 ส่งผลการจัดส่งรายการ

API การส่งผลการจัดส่งสินค้าคือ API ที่ส่งผลการจัดส่งสินค้าไปยังผู้ใช้ที่ได้ทำการซื้อสินค้าบริโภคผ่าน Hive IAP v4 โดยการใช้งาน API นี้ ระบบ Hive IAP จะส่งสถานะการจัดส่งสินค้า ซึ่งเป็นสิ่งจำเป็นสำหรับการลงโทษผู้ใช้ที่ใช้สิทธิ์คืนเงินในทางที่ไม่เหมาะสม แทนที่จะเป็น รายการคืนเงินและการยกเลิกของตลาด

URL การร้องขอ

URL เชิงพาณิชย์ https://hiveiap.qpyou.cn/api_v4/item_result
URL Sandbox https://sandbox-hiveiap.qpyou.cn/api_v4/item_result
วิธีการ HTTP POST
ประเภทเนื้อหา text/HTML;charset=utf-8
รูปแบบข้อมูล JSON
ฟิลด์ ประเภท คำอธิบาย จำเป็น
hiveiap_transaction_id สตริง ส่งค่าที่คืนจาก hiveiap_transaction_id จาก Hive IAP v4 การตรวจสอบใบเสร็จ Y
result_status จำนวนเต็ม ว่ารายการได้รับการอนุมัติสำเร็จหรือไม่
0: การอนุมัติล้มเหลว
1: การอนุมัติสำเร็จ
Y
user_id_type สตริง ประเภทผู้ใช้ Hive (ใช้ค่าคงที่ player_id) Y
user_id สตริง รหัสผู้ใช้ Hive (player_id) Y
asset อาร์เรย์ ข้อมูลเกี่ยวกับรายการที่ได้รับการอนุมัติ
ส่งค่าเฉพาะเมื่อการอนุมัติสำเร็จ และตอบกลับด้วยอาร์เรย์ว่าง ([]) เมื่อการอนุมัติล้มเหลว
N
asset_id สตริง รหัสรายการ N
asset_name สตริง ชื่อรายการ N
quantity จำนวนเต็ม จำนวนรายการที่ได้รับการอนุมัติ N
game_payload_info อ็อบเจ็กต์ ค่าที่ได้รับจากเซิร์ฟเวอร์เกมสำหรับเมตริกเพิ่มเติมใน Hive Analytics 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"}