개발자 센터

에러 코드

카플랫 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 서버) 연동 에러
    E066
    • Rental 서비스 통신에 문제가 있습니다.
    Carplat Rental 서비스 에러Carplat Rental 연동 이력 확인
    E067
    • 면허 검증에 실패했습니다.
    Legacy(Rims API 서버) 연동 에러
    E068
    • 해당기능을 처리할 수 없습니다:
    SGIS 연동 에러SGIS 연동 이력 확인
    E069
      수요 채널 연동 서비스 에러각 수요 채널 연동 이력 확인

      특수 에러 코드

      특정 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과 협의 완료)
      C009
      • 선택한 차량에 필요한 연료탱크 또는 이미지 정보가 등록되어 있지 않습니다. 관리자에게 문의해 주세요.
      상품 등록시 차종정보가 미등록 되어 있는 경우(하나의 인터페이스로 다른 체크로직에서 C002 를 사용하고 있어 구분을 위해 별도 생성)메시지 표시 + 데이터 리스트를 전달하여 표시

      409 Conflict (특수)

      에러 코드메시지 예시원인처리
      C007
      • 단말기 연동에 실패 하였습니다. 단말기 정보가 변경 되었습니다.
      단말기 연동 시, 연동 시도 시의 정보와 현재 갱신 된 정보를 비교 하여 변경 유무를 확인
      C010
      • 선택한 일시는 다음과 같은 사유로 연장 조건에서 벗어납니다. - 운영시간 외 - 휴무일 포함 - 다음 예약과의 간격 미확보 그래도 연장을 진행하시겠습니까?
      예약 연장시 운영시간, 휴무일, 예약간 간격을 각각 체크하고 위반일 경우 에러 메시지 리스트에 해당하는 메시지를 저장하여 보내야함.메시지 표시 + 데이터 리스트를 전달하여 표시

      에러 처리 가이드

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

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

      2. 서버 에러 (5xx)

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

      3. 특수 에러 (Cxxx)

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