Hive การอ้างอิง API เซิร์ฟเวอร์¶
คู่มือนี้อธิบาย Hive API เซิร์ฟเวอร์ที่จำเป็นในการใช้ Hive แพลตฟอร์ม; การตรวจสอบโทเค็น Auth v4 API และ IAP การตรวจสอบใบเสร็จ v4 API และชี้แจงวิธีการดำเนินการ รายการ.
จำเป็นต้องมี server API¶
การตรวจสอบโทเค็น Auth v4¶
● API คู่มือ: การตรวจสอบโทเค็นการรับรองความถูกต้อง v4
การตรวจสอบโทเค็น API จะตอบสนองโดยการตรวจสอบการตรวจสอบโทเค็นที่ส่งคืนจากไคลเอนต์เกมหลังจากการเข้าสู่ระบบที่สำเร็จ หากเกมไม่อนุญาตให้เข้าสู่ระบบซ้ำ คุณต้องบันทึกโทเค็นของผู้ใช้ที่เข้าสู่ระบบและดำเนินการทำให้โทเค็นที่ใช้ในการเข้าสู่ระบบก่อนหน้านี้ไม่ถูกต้อง เช่น การออกจากระบบหรือการสิ้นสุดเกม เซิร์ฟเวอร์การตรวจสอบโทเค็นให้บริการในสภาพแวดล้อมที่กระจายสำหรับการเชื่อมต่อที่ไม่ดีด้วยเซิร์ฟเวอร์ต่างประเทศ หากการตรวจสอบโทเค็นไม่ตอบสนองผ่าน URL ทั่วไป คุณควรดำเนินการฟังก์ชันที่ขอการตรวจสอบอีกครั้งผ่าน URL ในสภาพแวดล้อมที่กระจาย
IAP v4 การตรวจสอบใบเสร็จ¶
● API คู่มือ: IAP v4 การตรวจสอบใบเสร็จ
การตรวจสอบใบเสร็จ API จะทำการตรวจสอบใบเสร็จที่ซื้อในแอปและตอบกลับด้วยผลการตรวจสอบว่าใบเสร็จได้รับการประมวลผลตามปกติหรือไม่ ดูภาพด้านล่างเพื่อเรียนรู้เพิ่มเติมเกี่ยวกับกระบวนการซื้อด้วย IAP v4.
จำเป็นต้องขอการตรวจสอบใบเสร็จจากเซิร์ฟเวอร์เกมไปยังเซิร์ฟเวอร์ Hive ก่อนที่จะส่งมอบรายการให้กับผู้ใช้ที่ชำระเงินสำหรับรายการในเกม นอกจากนี้ คุณสามารถตรวจสอบได้ว่าควรส่งมอบรายการหรือไม่ โดยอิงจาก hiveiap_transaction_id
และ hiveiap_market_pid
ซึ่งเป็นการตอบสนองต่อการตรวจสอบใบเสร็จ
ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น |
hiveiap_transaction_id | รหัสธุรกรรมที่สร้างโดยการตรวจสอบใบเสร็จที่สำเร็จ ค่านี้จะถูกบันทึกในเซิร์ฟเวอร์เกมเพื่อตรวจสอบใบเสร็จที่ซ้ำกัน ส่งมอบเฉพาะเมื่อรหัสตอบกลับเป็น 0 (การตรวจสอบสำเร็จ) | String | N |
hiveiap_market_id | รหัสตลาดที่แยกแยะร้านค้าที่ผู้ใช้ชำระเงิน 1: Apple App Store 2: Google Play Store 3: Lebi 4: ONE store ส่งมอบเฉพาะเมื่อรหัสตอบกลับเป็น 0 (การตรวจสอบสำเร็จ) | Integer | N |
hiveiap_transaction_id
เป็นคีย์เฉพาะของใบเสร็จที่ได้รับการตรวจสอบอย่างสำเร็จซึ่งออกให้ เพื่อไม่ให้ใบเสร็จซ้ำกัน ค่าจะถูกบันทึกในเซิร์ฟเวอร์เกมเมื่อส่งของ และจากนั้นคุณสามารถตัดสินใจได้ว่าใบเสร็จนั้นได้ถูกใช้หรือไม่ การตรวจสอบใบเสร็จเป็นพื้นฐานเพียงอย่างเดียวในการคืนค่าโดย Hive Server นอกจากนี้ Hive Server ไม่สามารถแยกแยะได้ว่าใบเสร็จได้รับการตรวจสอบหลังจากความพยายามในการซื้อหรือจากการกู้คืนเนื่องจากความล้มเหลวในการส่งของhiveiap_market_pid
เป็นข้อมูลของรายการที่ถูกดึงออกมาจากใบเสร็จหรือผลการตรวจสอบของใบเสร็จ ข้อมูลของรายการที่ส่งผ่านไคลเอนต์มีความเสี่ยงต่อการเปลี่ยนแปลงในหน่วยความจำ ดังนั้นคุณต้องตัดสินใจและส่งของตามค่าดังกล่าว
รายการ¶
item เป็นระบบที่ใช้ในการรวมและจัดการฟีเจอร์การส่งและการดึงเงินเกม & ไอเท็มในเกม โดยใช้ item คุณสามารถเชื่อมต่อกับระบบที่หลากหลาย เช่น ระบบคูปอง, กิจกรรม, offerwall และ CPI เพื่อส่งหรือดึงไอเท็ม และมีสำนักงานหลังสำหรับผู้ดูแลระบบเพื่อค้นหาประวัติการส่งและดึงไอเท็มด้วยตนเอง
โครงสร้างของ Item คือถ้า Item Server เรียกใช้ send item API หรือ retrieve item API ไปยังเกมเซิร์ฟเวอร์ เกมเซิร์ฟเวอร์จะตอบสนองต่อคำขอ สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับ Server API ไปที่ API > Hive Server API > Billing > Sync with Item บน Hive Developers.
Note
ตรวจสอบให้แน่ใจว่าลงทะเบียนเซิร์ฟเวอร์เกม URL และรายการในเมนู การจัดการรายการ ของ Hive Console เพื่อซิงค์กับมัน สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการจัดการรายการ ดู ที่ การดำเนินการ > การเรียกเก็บเงิน > หน้า การจัดการรายการ บน Hive Developers.