개발자 센터

개발자 센터

에러 코드

카플랫 API가 응답하는 에러 코드를 설명합니다.

카플랫 API에서 발생할 수 있는 모든 에러 코드와 처리 방법을 설명합니다.

에러 응답 구조

API 요청이 실패하면 다음과 같은 구조로 에러 정보가 응답됩니다:

json

Loading...

응답 필드 설명

code (필수): 성공 또는 실패 여부를 나타내는 에러 코드
message (필수): 에러 발생 사유를 설명하는 메시지
result (선택): 에러 원인에 대한 추가 정보가 필요한 경우 포함

일반 에러 코드

400 Bad Request

에러 코드	메시지 예시	원인	처리
E001	deleteYn: 'a'는 형식이 맞지 않습니다	HTTP 메시지 변환 불가할 때	데이터 포맷 및 유효 값 확인
E001	name: 길이가 6에서 20 사이여야 합니다 name: 널이어서는 안됩니다	유효성 검사가 실패할 때	데이터 포맷 및 유효 값 확인
E001	deleteYn: 'a'는 형식이 맞지 않습니다	HTTP 메시지 변환 불가할 때	데이터 포맷 및 유효 값 확인
E001	name: 필수 요청 인자값 입니다	유효성 검사가 실패할 때	데이터 포맷 및 유효 값 확인
E001	평일 - 운영 시작/종료시를 설정해야 합니다	비즈니스 로직 상 유효성 검사 실패	데이터 포맷 및 유효 값 확인
E004	최대 7일 조회 가능합니다 종료일은 시작일 이후로 선택 가능합니다 날짜 범위를 지정해야 합니다	기간 검색이 불가할 때	데이터 포맷 및 유효 값 확인

401 Unauthorized

에러 코드	메시지 예시	원인	처리
A001	유효하지 않은 토큰입니다	인증 실패	인증 확인
A002	만료된 토큰입니다	인증 실패	인증 확인
A004	입력하신 정보와 일치하는 계정이 없습니다	잘못된 인증 정보	인증 확인

404 Not Found

에러 코드	메시지 예시	원인	처리
E002	해당 기능은 지원되지 않습니다	HTTP 리소스를 찾을 수 없을 때	API 확인 (path)
E002	해당 기능은 지원되지 않습니다	HTTP 메소드를 지원하지 않을 때	API 확인 (method)
E003	조회된 데이터가 없습니다	특정 리소스를 찾을 수 없을 때	식별값 (Id 값) 유효성 확인

409 Conflict

에러 코드	메시지 예시	원인	처리
E010	데이터 정합성 위반으로 해당 기능을 처리할 수 없습니다	데이터에 국한되지 않고 무결성 제약 조건을 위반	식별값 (Id 값) 정합성 확인
E011	이미 등록된 카테고리 명이 있습니다	비즈니스 로직 상 특정 리소스 충돌	중복 확인
E012	업체 관리자는 삭제할 수 없습니다	요청한 기준을 준수하는 리소스를 찾지 못할 때	요청 조건 확인

500 Internal Server Error

에러 코드	메시지 예시	원인	처리
E051	해당 기능을 처리할 수 없습니다. 관리자에게 문의하세요	지정된 SQL이 유효하지 않은 경우	Database Mapper 확인
E052	해당 기능을 처리할 수 없습니다. 관리자에게 문의하세요	RDBMS를 사용할 때 잘못된 SQL을 지정할 때 발생	Database Mapper 확인
E053	해당 기능을 처리할 수 없습니다. 관리자에게 문의하세요	일시적이지 않은 것으로 간주되는 데이터 액세스 예외	Database Mapper 확인
E055	해당 기능을 처리할 수 없습니다. 관리자에게 문의하세요	적절한 Exception 핸들링 미처리	Handler 확인
E050	일시적인 장애로 서비스를 이용하실 수 없습니다	JDBC 오류	Database 접속 상태 확인

503 Service Unavailable

에러 코드	메시지 예시	원인	처리
E060	잠시 후 다시 시도해 주세오. 증상이 반복될 경우 관리자에게 문의하세요	드물게 발생 할 수도 있는 알 수 없는 예외	Handler 확인
E061	sms 전송에 실패했습니다	외부 메시징 연동 서비스 예외	인포뱅크 연동 이력 확인
E062	오토비긴즈 전달값	통신에 문제가 있어 정보를 불러오지 못했습니다. 잠시 후 다시 시도해 주세요
E063	아이나비 전달값	Error : 주소 변환에 실패하였습니다. 다시 시도해주세요
E064		Kakao T rent 연동 서비스 에러	Kakao 연동 이력 확인
E065	통신에 문제가 있어 정보를 불러오지 못했습니다. 잠시 후 다시 시도해 주세요	Legacy(C# API 서버) 연동 에러

특수 에러 코드

특정 API 요청에서만 나타날 수 있는 실패 응답 코드입니다.

400 Bad Request (특수)

에러 코드	메시지 예시	원인	처리
C001	비밀번호가 일치하지 않습니다	비밀번호 변경 시 기존 비밀번호 불일치 예외
C002	차량을 제외하고 등록해 주세요 해당 차량으로 등록된 상품이 있습니다	상품 등록시 다른 상품에 등록되어 있는 차량을 등록하려는 경우	메시지 표시 + 데이터 리스트를 전달하여 표시
C003	대여 요금이 올바르지 않습니다	예약생성시 계산된 요금과 입력된 요금이 틀릴 경우(KM에서 예약 등록시 E012와 분리해달라는 요청으로 생성)
C004	허용되지 않은 확장자입니다	허용되지 않은 확장자로 업로드할 경우 (프론트 파일 업로드시 E012 에러코드와 분리해달라는 요청으로 생성)
C005	유효하지 않은 상품 입니다	예약 등록시 입력받은 조건에 해당하는 차량이 없는 경우(검색과 예약 사이에 다른 예약으로 등록된 경우 등)(KM에서 예약 등록시 E012와 분리해달라는 요청으로 생성)
C006	단말기가 이미 다른 차량에 연동되어 있습니다	단말기 연동 시, 연결 하려는 TID가 다른차량에 이미 연동 되어 있는지 유무를 확인
C008	차량정보 조회에 실패했습니다. 자동차등록증의 소유자와 차량번호가 정확히 일치하는지 확인해 주세요	오토비긴즈 차량정보 조회 실패시 사용. Carplat DB 의 데이터가 아니라 오토비긴즈 조회 결과가 없을 경우에 한해서만 사용. 기존에 별도의 로직으로 ResourceNotFoundException을 사용중이여서 별개 코드로 분리
E8000	단말 연동 에러	Otoplug 단말기 연동 에러 오류 발생 시 출력(KM API Response에 Otoplug 오류 코드를 그대로 전송, KM과 협의 완료)

409 Conflict (특수)

에러 코드	메시지 예시	원인	처리
C007	단말기 연동에 실패 하였습니다. 단말기 정보가 변경 되었습니다	단말기 연동 시, 연동 시도 시의 정보와 현재 갱신 된 정보를 비교 하여 변경 유무를 확인

에러 처리 가이드

1. 클라이언트 에러 (4xx)

원인: 잘못된 요청 데이터, 인증 실패, 리소스 없음
처리: 요청 데이터 검증, 인증 정보 확인, API 문서 참조

2. 서버 에러 (5xx)

원인: 서버 내부 오류, 외부 서비스 연동 실패
처리: 잠시 후 재시도, 지속 시 관리자 문의

3. 특수 에러 (Cxxx)

원인: 특정 비즈니스 로직 위반
처리: 에러 메시지에 따른 데이터 수정 후 재시도