หมายเหตุ

นี่อธิบายข้อมูลที่ต้องอ้างอิงเมื่อใช้ API การจับคู่

รหัสข้อผิดพลาด¶

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

รหัสข้อผิดพลาดสามารถตรวจสอบได้เป็นค่าการตอบสนองสำหรับแต่ละคำขอ API การจับคู่ และมีโครงสร้างในรูปแบบข้อมูล JSON ดังต่อไปนี้

// 예시)
{
    "code": 11001,
    "reason": "already group member"
}

Note

ในการตอบกลับรหัสข้อผิดพลาด ค่าแต่ละ code จะถูกกำหนดไว้ แต่ reason (สาเหตุของข้อผิดพลาด) อาจมีการปรับเปลี่ยนตามการอัปเดต API.

ประเภทของรหัสข้อผิดพลาดที่ให้ตามข้อผิดพลาดในการตอบสนองของ API มีดังนี้

รหัสข้อผิดพลาดทั่วไป¶

รหัส	คำอธิบาย
1000	ข้อผิดพลาดของระบบเซิร์ฟเวอร์ภายใน
1001	มีปัญหาเกี่ยวกับความถูกต้องของค่าของ body ในข้อมูลคำขอ
1002	ข้อผิดพลาดของเซิร์ฟเวอร์ API
1100	ใน API ที่ใช้ HTTP METHOD - GET, หากค่าของ PARAM ที่จำเป็นขาดหายไป

รหัสข้อผิดพลาดการตรวจสอบสิทธิ์ API¶

รหัส	คำอธิบาย
2000	`Hive Certification Key` ขาดหายไป
2001	ค่าของ `Hive Certification Key` ไม่ถูกต้อง
2002	ค่าของ `gameIndex` ไม่ถูกต้อง
2100	API นี้ไม่สามารถใช้งานได้
2200	ไม่มีข้อมูลสำหรับการตรวจสอบการรับรองความถูกต้อง
2201	หากข้อมูลที่ใช้สำหรับการตรวจสอบการรับรองความถูกต้องอยู่ในรูปแบบที่ไม่รองรับ
2300	ข้อมูลที่ใช้สำหรับการรับรองความถูกต้องของ Hive SDK ไม่ถูกต้อง
2310	ไม่ใช่ `appId` ที่ลงทะเบียน
2320	ล้มเหลวในการทำคำขอการรับรองความถูกต้องของ Hive SDK

รหัสข้อผิดพลาดทั่วไปของ API¶

รหัส	คำอธิบาย
3000	ไม่สามารถดึงข้อมูลเกี่ยวกับผู้ใช้ API
3001	ไม่สามารถดึงค่า `gameIndex` จาก API Path
3002	ไม่สามารถดึงข้อมูล `matchId` จาก API Path
3003	ไม่สามารถอ่านเนื้อหาของร่างคำขอ (ปัญหาการวิเคราะห์)
3004	ไม่สามารถดึงข้อมูล `playerId` จากคำขอ
3005	ไม่สามารถดึงข้อมูล `targetPlayerId` จากคำขอ

รหัสข้อผิดพลาดที่เกี่ยวข้องกับ Match ID (`matchId`)¶

รหัส	คำอธิบาย
4000	ไม่สามารถดึงข้อมูล `matchId` ได้
4001	ไม่สามารถรับค่า `gameIndex` จาก API Path ได้
4100	ข้อมูลไม่ถูกต้องที่จำเป็นสำหรับการสร้างหรือแก้ไข `matchId`

รหัสข้อผิดพลาดที่เกี่ยวข้องกับ API ส่วนบุคคล¶

รหัส	คำอธิบาย
10000	การร้องขอที่ตรงกันกำลังดำเนินการอยู่แล้ว (การร้องขอซ้ำ)
10100	เมื่อทำการลบการร้องขอที่ตรงกัน ไม่มีการร้องขอให้ลบ

รหัสข้อผิดพลาดที่เกี่ยวข้องกับ API กลุ่ม¶

รหัส	คำอธิบาย
11000	ไม่เป็นส่วนหนึ่งของกลุ่ม
11001	อยู่ในกลุ่มแล้ว
11002	ไม่ใช่สมาชิกของกลุ่มนี้
11003	ไม่ใช่ผู้นำกลุ่ม
11004	ไม่สามารถค้นหากลุ่มที่ตรงกับรหัสที่ป้อน
11005	ไม่สามารถใช้ได้ในขณะที่เป็นสมาชิกของกลุ่ม
11006	ไม่สามารถใช้ได้ในระหว่างการจับคู่ (กลุ่ม)
11100	ไม่สามารถสร้างในขณะที่การจับคู่ (บุคคล) กำลังดำเนินอยู่
11101	ไม่สามารถสร้างหากไม่ใช่การจับคู่ทีม
11200	การจับคู่กลุ่มกำลังดำเนินอยู่ (ซ้ำ)
11201	มีสมาชิกที่ยังไม่พร้อม
11202	ไม่มีสมาชิกอื่น (ไม่สามารถขอได้เพียงลำพัง)
11300	ไม่สามารถเปลี่ยนแปลงได้เนื่องจากการจับคู่กำลังดำเนินอยู่
11301	ไม่สามารถเปลี่ยนผู้นำกลุ่มได้
11400	ไม่สามารถเข้าร่วมได้เนื่องจากสมาชิกเต็ม
11401	ไม่สามารถเข้าร่วมได้เนื่องจากข้อจำกัดตามกฎการจับคู่ (คะแนน ฯลฯ)
11402	`matchId` ไม่สามารถเข้าร่วมกลุ่มอื่นได้
11500	สมาชิกที่เตรียมพร้อมไม่สามารถออกได้
11600	ไม่มีคำขอจับคู่เพื่อลบ
11700	ผู้นำกลุ่มไม่สามารถขับไล่ได้โดยไม่สมัครใจ