참고 사항

매치 메이킹 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 값이 누락된 경우

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

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

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

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