에러 코드

정보

이 문서는 차량 소유자용 API의 인증 관련 에러 코드를 설명합니다. Vehicle Data API 호출 중 발생하는 에러 코드는 개인 사용자와 비즈니스 사용자에게 공통으로 적용되므로, Business Users API 에러 코드를 참조하세요.

Error Response

에러 발생 시 응답 메시지 포맷
{
  "error": {
    "code": "40001",
    "message": "Invalid Parameters",
    "requestId": "835bdbd4-1105-4a8c-b438-fa0873d1b246",
    "details": [
      {
        "field": "identifier",
        "issue": "공백일 수 없습니다."
      }
    ],
    "timestamp": "2026-07-03T10:00:00+09:00"
  }
}

필드	타입	설명	필수 여부
error	object	오류 정보	Required
error.code	string	에러 코드	Required
error.message	string	오류 메시지	Required
error.requestId	string	요청 ID	Required
error.details	array of object	오류 상세	Required
error.details.field	string	오류가 발생한 필드	Optional
error.details.issue	string	필드별 오류 내용	Optional
error.timestamp	string	타임 스탬프	Required

Error Code

Status Code	Error Code	설명	조치
400	40001	잘못된 파라미터	`details` 필드에서 오류 필드를 확인합니다.
400	40002	Authorization 헤더 없음	Bearer 토큰을 추가합니다.
400	40003	토큰 만료	Create Access Token을 다시 호출하여 새 액세스 토큰을 발급받습니다.
400	40004	유효하지 않은 토큰	재로그인 후 신규 발급합니다.
404	40404	사용자 또는 Key 없음	`clientId` 및 `identifier`를 확인합니다.
500	50001	내부 서버 오류	잠시 후 재시도합니다.
502	50201	외부 연동 오류	잠시 후 재시도합니다.

Error Response​

Error Code​

Error Response

Error Code