ส่งข้อมูลการบริโภค

เรามี API สำหรับส่งข้อมูลการบริโภคของผู้ใช้ไปยัง App Store เมื่อผู้ใช้แอปขอคืนเงิน

API 'ส่งข้อมูลการบริโภค' ทำงานผ่านการสื่อสารแบบ Server-to-Server ระหว่างเซิร์ฟเวอร์ Hive และเซิร์ฟเวอร์แอป โดยเซิร์ฟเวอร์ Hive จะส่งคำขอส่งข้อมูลการบริโภคไปยังเซิร์ฟเวอร์แอป และเซิร์ฟเวอร์แอปจะส่งค่าตอบกลับกลับไปยังเซิร์ฟเวอร์ Hive

การเปลี่ยนแปลงจาก V1 เป็น V2¶

สรุปการเปลี่ยนแปลงที่ต้องเชื่อมต่อใน V2 API เมื่อเทียบกับการส่งข้อมูลการบริโภค V1แบบเดิม

ขั้นตอนการทำงาน¶

สรุปขั้นตอนการทำงานทั้งหมดของการเรียกใช้และการตอบกลับ API 'ส่งข้อมูลการบริโภค' ได้ดังนี้

1. แอป: เตรียม URL เซิร์ฟเวอร์โดยกำหนดค่า API endpoint
2. แอป: เลือกเปิดใช้งานการส่งข้อมูลการบริโภคในคอนโซล Hive และลงทะเบียน URL เซิร์ฟเวอร์
3. ไคลเอนต์แอป: ยินยอมให้ส่งข้อมูลการบริโภคสินค้าในแอปขณะที่แอปกำลังทำงานอยู่
4. ผู้ใช้แอป: ขอคืนเงินในแอป
5. เซิร์ฟเวอร์ Hive: ส่งคำขอ POST API ไปยัง URL เซิร์ฟเวอร์ที่แอปลงทะเบียนไว้ และรับข้อมูลการบริโภคเป็นค่าตอบกลับจากเซิร์ฟเวอร์แอป
6. เซิร์ฟเวอร์ Hive: ส่งข้อมูลการบริโภคไปยัง App Store

ข้อมูลการบริโภคที่จะส่งไปยัง App Store บางส่วนมีอยู่เฉพาะบนเซิร์ฟเวอร์แอปเท่านั้น ในกรณีนี้ หากต้องการให้เซิร์ฟเวอร์ Hive ส่งข้อมูลการบริโภคไปยัง App Store เซิร์ฟเวอร์แอปต้องส่งข้อมูลไปยังเซิร์ฟเวอร์ Hive ก่อน

URL เซิร์ฟเวอร์แอปคือ API endpoint ที่เซิร์ฟเวอร์แอปเปิดไว้เพื่อส่งข้อมูลไปยังเซิร์ฟเวอร์ Hive หลังจากกำหนดค่า API endpoint แล้วลงทะเบียนเป็น URL เซิร์ฟเวอร์แอป ทุกครั้งที่ผู้ใช้ขอคืนเงิน เซิร์ฟเวอร์ Hive จะส่งคำขอ POST ไปยัง API endpoint นี้และรับข้อมูลที่จำเป็นจากเซิร์ฟเวอร์แอป เซิร์ฟเวอร์ Hive จะรวบรวมข้อมูลนี้และดำเนินการส่งข้อมูลการบริโภคไปยัง App Store แทนแอป

การกำหนดค่า API endpoint (URL เซิร์ฟเวอร์)¶

เมื่อเซิร์ฟเวอร์แอปได้รับคำขอผ่าน API endpoint ที่จะลงทะเบียนเป็น URL เซิร์ฟเวอร์ ต้องรวบรวมข้อมูลรายผู้ใช้แอป (consumption_status, play_time, refund_preference, sample_content_provided) และตอบกลับด้วยข้อมูลที่รวบรวมแล้วซึ่งสามารถค้นหาได้ด้วยข้อมูลผู้ใช้ (CS_CODE) ที่อยู่ในพารามิเตอร์คำขอ

ปิดกฎไฟร์วอลล์¶

ปิดกฎไฟร์วอลล์ขาเข้าเพื่ออนุญาตให้มีการสื่อสาร API ระหว่างเซิร์ฟเวอร์แอปและเซิร์ฟเวอร์ Hive คุณต้องปิดกฎไฟร์วอลล์ขาเข้าสำหรับที่อยู่ IP ด้านล่างบนเซิร์ฟเวอร์แอป

หลังจากปิดกฎไฟร์วอลล์แล้ว โปรดดูข้อมูลด้านล่างเพื่อกำหนดค่า API endpoint

การกำหนดค่า API request (เซิร์ฟเวอร์ Hive → เซิร์ฟเวอร์แอป)¶

นี่คือข้อมูลคำขอ POST ที่ส่งจากเซิร์ฟเวอร์ Hive ไปยังเซิร์ฟเวอร์แอป

Request body¶

ข้อมูล Request body มีดังนี้

ตัวอย่าง Request body มีดังนี้

{
    "gameindex": "539",
    "appid": "com.com2us.hivesdk.normal.freefull.apple.global.ios.universal",
    "user_seq": "222333"
}

การกำหนดค่า API response (เซิร์ฟเวอร์แอป → เซิร์ฟเวอร์ Hive)¶

นี่คือข้อมูลที่เซิร์ฟเวอร์แอปส่งกลับไปยังเซิร์ฟเวอร์ Hive

Response body¶

ข้อมูลค่าการตอบสนองที่เซิร์ฟเวอร์แอปต้องส่งไปยังเซิร์ฟเวอร์ Hive เมื่อการตอบสนองสำเร็จ มีดังนี้

ตัวอย่างการตอบกลับสำเร็จมีดังนี้

// success
{
    "code": 100,
    "message": "OK",
    "data": {
        "consumption_status": 0,
        "play_time": 1,
        "refund_preference": 2,
        "sample_content_provided": 0
    }
}

ตัวอย่างการตอบกลับล้มเหลวมีดังนี้

// Errors due to wrong parameters
{
    "code": 400,
    "message": "No parameter, or invalid parameter name."
}

// Errors due to invalid user information
{
    "code": 200,
    "message": "No data, or invalid cs_code."
}

รหัสการตอบกลับ¶