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

API การจับคู่

คุณสามารถใช้ matchmaking กับเกมโดยใช้ Matchmaking API

API การจับคู่ประกอบด้วย Private Match API และ Group Match API เป็นหลัก นอกจากนี้ เมื่อการจับคู่เสร็จสิ้น คุณสามารถตรวจสอบสถานะการจับคู่ได้ผ่าน Matching Result Callback API

ข้อกำหนดเบื้องต้น

ในการใช้ API การจับคู่ จำเป็นต้องมีรายการต่อไปนี้

  • โทเค็นการรับรองความถูกต้องสำหรับการเรียก API (Hive Certification Key): สามารถพบได้ในคอนโซล Hive ภายใต้ App Center > Project Management > Select App after searching > Game Details > Basic Information > Hive Certification Key
  • ดัชนีเกม (gameIndex): สามารถพบได้ในคอนโซล Hive ภายใต้ App Center > Project Management > Select App after searching > Game Details > Basic Information > Game Index
  • Match ID (matchId): สามารถพบได้เมื่อสร้างแมตช์ในคอนโซล Hive

ข้อมูลพื้นฐาน

นี่อธิบายข้อมูลพื้นฐานที่คุณจำเป็นต้องรู้โดยทั่วไปก่อนที่จะใช้ API การจับคู่

URL การร้องขอ

API การจับคู่จะร้องขอที่ URL ด้านล่างนี้

เซิร์ฟเวอร์ URL
LIVE api-match.withhive.com
SANDBOX sandbox-api-match.withhive.com

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

รหัสสถานะการตอบกลับ HTTP ที่ใช้บ่อยเมื่อทำการร้องขอไปยัง API การจับคู่

นอกจากรหัสการตอบกลับแล้ว คุณสามารถตรวจสอบรหัสข้อผิดพลาดที่ให้โดยเซิร์ฟเวอร์ Hive ในกรณีที่เกิดข้อผิดพลาดในการดำเนินการ API การจับคู่ได้ใน เอกสารอ้างอิง

รหัส ค่า คำอธิบาย
200 สำเร็จ ดูที่การตอบสนอง API แต่ละรายการ
400 คำขอไม่ถูกต้อง พารามิเตอร์คำขอหรือข้อมูลในคำขอไม่ถูกต้อง
401 ไม่ได้รับอนุญาต ส่วนหัวการอนุญาตในข้อความคำขอขาดหายไปหรือค่าของมันไม่ถูกต้อง
403 ห้ามเข้าถึง โทเค็นการตรวจสอบสิทธิ์ (Hive Certification Key) สำหรับการเรียก API ไม่ถูกต้อง
404 ไม่พบ พาธ API ไม่ถูกต้อง
500 ข้อผิดพลาดของเซิร์ฟเวอร์ภายใน เกิดปัญหาภายในเซิร์ฟเวอร์