본문으로 건너뛰기

에러 코드

응답 형식​

모든 API 응답은 동일한 형식을 따릅니다.

성공:

{
  "status": "success",
  "data": { ... },
  "errorType": null,
  "errorCode": null,
  "message": null
}

실패:

{
  "status": "error",
  "data": null,
  "errorType": "ExceptionClassName",
  "errorCode": null,
  "message": "에러 설명"
}

에러 코드 목록​

400 Bad Request​

errorType설명
IllegalArguemntError잘못된 입력값
MethodArgumentNotValidException@Valid 검증 실패 (필수 파라미터 누락 등)
ResourceNotExistException조회 대상이 존재하지 않음 (예약 이력 없음 등)

401 Unauthorized​

errorType설명
AuthenticationError세션 없음 (로그인 필요)
LoginFailExceptionID/PW 불일치
ResourceTimeOutException외부 서비스 응답 시간 초과

403 Forbidden​

errorType설명
AuthorizationError관리자 권한 없음
AuthorizationException접근 권한 없음

404 Not Found​

errorType설명
ResourceNotFoundException리소스를 찾을 수 없음

409 Conflict​

errorType설명
InvalidCodeException인증코드 불일치
ResourceAlreadyExistException리소스 중복
ResourceUnavailableException슬롯/머신 사용 불가
TossDataIntegrityException결제 데이터 불일치
SettingConflictException예약 시간 충돌 (충돌 상세 정보가 data에 포함)

410 Gone​

errorType설명
ResourceValidTimePassedException인증코드 만료 (3분 초과)

503 Service Unavailable​

errorType설명
AsyncRequestTimeoutExceptionSSE 타임아웃 (도어락 제어 시 정상 케이스)

500 Internal Server Error​

errorType설명
예외 클래스 풀네임처리되지 않은 서버 오류