콘텐츠로 이동

참고 사항

매치 메이킹 API 사용 시, 참고하는 정보를 설명합니다.

에러 코드

매치 메이킹 API 요청이 정상적으로 처리되지 않았을 경우, 원인을 확인할 수 있는 정보로 HTTP 응답 상태 코드 외에 별도의 에러 코드를 제공합니다.

에러 코드는 각 매치 메이킹 API 요청에 대한 응답값으로 확인할 수 있으며, 아래와 같은 JSON 데이터 형식으로 구성됩니다.

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

에러 코드 응답에서 각 code의 value는 고정된 값이나, reason (에러 원인)은 API 업데이트에 따라 문구가 수정될 수 있습니다.

API 응답 오류에 따라 제공되는 에러 코드 종류는 아래와 같습니다.

일반 에러 코드

Code 설명
1000 서버 내부 시스템 오류
1001 요청 데이터 중, body 의 값에 유효성 문제가 있는 경우
1002 API 서버 오류
1100 HTTP METHOD - GET 을 사용하는 API 중에, 필요한 PARAM 값이 누락된 경우

API 인증 관련 에러 코드

Code 설명
2000 Hive Certification Key 가 없음
2001 Hive Certification Key 의 값이 잘못됨
2002 gameIndex 값이 잘못됨
2100 해당 API 는 사용할 수 없음
2200 인증 확인에 사용할 데이터가 없음
2201 인증 확인에 사용할 데이터가 지원하지 않는 형식일 경우
2300 Hive SDK 인증에 사용할 데이터가 올바르지 않음
2310 등록된 appId 가 아님
2320 실제 Hive SDK Auth 요청에 실패함

API 공용 에러 코드

Code 설명
3000 API 사용 주체 정보를 얻는데 실패함
3001 API Path 에서 gameIndex 값을 얻어올 수 없음
3002 API Path 에서 matchId 정보를 얻을 수 없음
3003 request body 내용을 읽을 수 없음 (parsing 문제)
3004 request 에서 playerId 정보를 얻지 못함
3005 request 에서 targetPlayerId 정보를 얻지 못함

매치 ID (matchId) 관련 에러 코드

Code 설명
4000 matchId 정보를 불러 올 수 없음
4001 API Path 에서 gameIndex 값을 얻어올 수 없음
4100 matchId 생성 혹은 수정에 필요한 정보가 잘못되어 있음

개인 API 관련 에러 코드

Code 설명
10000 매칭 요청이 이미 진행 중 (중복 요청)
10100 매칭 요청 삭제시 삭제할 요청이 없는 경우

그룹 API 관련 에러 코드

Code 설명
11000 그룹에 속해있지 않음
11001 이미 속한 그룹이 있음
11002 이 그룹에 속한 멤버가 아님
11003 그룹장(방장) 이 아님
11004 입력한 코드에 해당하는 그룹을 찾을 수 없음
11005 그룹에 속해 있을 때는 사용할 수 없음
11006 (그룹)매칭 진행 중에는 사용할 수 없음
11100 (개인) 매칭 진행 중에는 생성할 수 없음
11101 팀 매칭이 아닌 경우 생성할 수 없음
11200 그룹 매칭이 진행 중(중복)
11201 준비 상태가 안된 멤버가 있음
11202 다른 멤버가 없음(혼자서는 요청 불가)
11300 진행 중인 매칭이 있어서 변경 불가
11301 그룹장(방장)은 변경 불가
11400 멤버가 가득 차서 참여할 수 없음
11401 매칭 규칙에 따른 제한(점수 등)으로 참여할 수 없음
11402 matchId 가 다른 그룹에 참여할 수 없음
11500 준비 상태인 멤버는 나갈 수 없음
11600 삭제할 매칭 요청이 없음
11700 그룹장은 강제로 쫓아낼 수 없음