에러 코드

Error Response

에러 발생 시 응답 메시지 포맷

{
  "error": {
    "code": "4002",
    "message": "Invalid request parameters",
    "details": [],
    "timestamp": "2025-09-01T12:00:00Z",
    "requestId": "835bdbd4-1105-4a8c-b438-a1b2c3d4f5g6"
  }
}

필드	타입	설명	필수 여부
error	object	오류 정보	Required
└─ code	string	에러 코드	Required
└─ message	string	오류 메시지	Required
└─ details	array of object	오류 상세	Required
└─ timestamp	string	타임 스탬프	Required
└─ requestId	string	요청 Id	Required

Error Code

Status Code	Error Code	Error Message	Description
200	-	Success	성공
400	401	Unauthorized	인증되지 않은 클라이언트의 요청일 때 발생하는 에러 코드입니다.
400	403	Forbidden	액세스 권한이 없는 API를 요청했을 때 발생하는 에러 코드입니다.
400	404	NotFound	유효하지 않는 주소의 API를 요청했을 때 발생하는 에러 코드입니다.
400	4002	Invalid Request Parameters	유효하지 않은 파라미터(파라미터 누락, 잘못된 형식, 유효 범위 초과)로 요청했을 경우의 에러 코드입니다.
400	4011	Invalid Authorization Header	유효하지 않은 액세스 토큰으로 요청했을 때의 에러 코드입니다.
400	40002	No Auth Header	헤더 파라미터에 액세스 토큰이 없을 경우의 에러 코드입니다.
400	5006	The service does not have a permission to use data. No Permission Error	차량 데이터를 액세스할 권한이 없을 때 발생하는 에러 코드입니다. 차량 데이터 공유에 동의하지 않았거나, 데이터 공유를 철회한 차량의 데이터를 요청했을 때 발생합니다.
404	4045	No Data	해당 vin에 대한 데이터가 없을 경우의 응답 코드입니다.
410	4101	Unregistered Vehicle	차량 데이터 공유 차량으로 등록되지 않은 vin을 요청했을 경우의 에러 코드입니다.
500	5001	Internal Server Error	내부적으로 발생된 오류일 경우의 에러 코드입니다.