무료 VIN 디코더를 만들었습니다 (NHTSA API 사용) - 방법은 이렇습니다
Source: Dev.to
개요
모든 자동차는 17자리 VIN(차량 식별 번호)을 가지고 있으며, 이를 통해 연식, 제조사, 모델, 엔진, 안전 기능, 제조 공장 등 전체 정보를 인코딩합니다. 대부분의 VIN 디코더 사이트는 비용을 청구하거나 계정을 요구하지만, 저는 무료 대안을 만들었습니다.
NHTSA API
미국 고속도로 교통 안전국(NHTSA)은 VIN을 디코딩할 수 있는 공개 API를 제공하며, 키가 필요 없습니다:
https://vpic.nhtsa.dot.gov/api/vehicles/decodevinvalues/{VIN}?format=json
- API 키 불필요.
- 합리적인 사용 범위 내에서는 엄격한 속도 제한이 없습니다.
- VIN당 100개 이상의 필드를 반환하며, 여기에는 제조사, 모델, 연식, 엔진 사양, 안전 기능, 공장 위치 등이 포함됩니다.
반환되는 유용한 필드
| Field | Description |
|---|---|
| Make / Model / Year | 기본 차량 식별 정보 |
| BodyClass | 차체 스타일 (세단, SUV, 트럭 등) |
| DriveType | 구동 방식 (FWD, RWD, AWD, 4WD) |
| FuelTypePrimary | 연료 종류 (가솔린, 디젤, 전기) |
| EngineCylinders / DisplacementL | 엔진 사양 |
| AirBagLocFront / Side / Curtain | 에어백 위치 (안전 기능) |
| PlantCountry / PlantCity | 제조 위치 |
왜 중요한가
- 중고차 구매 – 판매자가 잘못 전달할 수 있는 트림 레벨, 엔진 옵션 및 기타 사양을 확인할 수 있습니다.
- 자동차 관련 애플리케이션 – 자체 차량 데이터베이스를 유지하지 않고도 재고 시스템, 딜러 도구 또는 마켓플레이스를 구축할 수 있습니다.
구현
웹 도구는 단순히 NHTSA 엔드포인트에 fetch 요청을 보내고, 응답 필드를 정리하여 화면에 표시합니다. VIN 파싱 로직(제조사 식별자, 체크 디지털, 연식 인코딩 등)은 모두 API가 처리합니다.
제한 사항
- 1981년 이전에 제작된 차량은 VIN이 17자보다 짧은 경우가 많아 데이터베이스에 해당 모델에 대한 정보가 없을 수 있습니다.
- 일부 해외 시장 전용 차량은 항목이 불완전할 수 있습니다.
- 1981년 이후 미국에서 판매된 차량에 대해서는 API가 일반적으로 포괄적이며 무료로 제공됩니다.
이용 가능성
디코더는 simplylouie.com/vin-decoder에서 무료 웹 도구로 제공됩니다. 회원가입이나 이메일 입력이 필요 없으며, VIN을 붙여넣기만 하면 결과를 확인할 수 있습니다.