Matchmaking API¶

Matchmaking API를 사용하여 게임에 매치 메이킹을 적용할 수 있습니다.

매치 메이킹 API는 크게 개인 매치 API와 그룹 매치 API로 구성됩니다. 또한 매칭 완료 시 매칭 결과 콜백 API를 통해 매칭 상태를 확인할 수 있습니다.

사전 준비 사항¶

매치 메이킹 API를 사용하려면 아래의 항목이 필요합니다.

• API 호출을 위한 인증 토큰(Hive Certification Key): Hive 콘솔의 앱센터 > 프로젝트 관리 > 앱 검색 후 앱 선택 > 게임 상세 > 기본정보 > Hive 인증키에서 확인 가능
• 게임 인덱스(gameIndex): Hive 콘솔의 앱센터 > 프로젝트 관리 > 앱 검색 후 앱 선택 > 게임 상세 > 기본정보 > Game Index에서 확인 가능
• 매치 ID(matchId): Hive 콘솔에서 매치 생성 시 확인 가능

기본 정보¶

매치 메이킹 API를 사용하기에 앞서 공통으로 알아야 할 기본 정보를 설명합니다.

Request URL¶

매치 메이킹 API는 아래의 URL로 요청합니다.

응답 코드¶

매치 메이킹 API 요청 시, 공통으로 사용되는 HTTP 응답 상태 코드입니다.

해당 응답 코드 외에, 매치 메이킹 API 동작 오류 시 Hive 서버에서 제공하는 에러 코드는 참고 사항에서 확인하세요.