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

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.