VIN으로 차량 리콜을 3줄 코드로 조회하는 방법

Source: Dev.to

빠른 버전

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.vehicle-finder.com/v1/recalls?vin=1HGCM82633A004352"

VIN에 대한 모든 리콜 정보를 구조화된 JSON 형태로 받아옵니다 – 캠페인 번호, 설명, 해결 방법, 완료 상태 등.

왜 NHTSA를 직접 사용하지 않을까?

직접 사용할 수는 있지만:

• NHTSA API는 기본적으로 XML을 반환하고 JSON 형식이 일관되지 않음
• 인증이 없으므로 속도 제한이 없고 가용성이 신뢰할 수 없음
• 데이터가 여러 엔드포인트에 흩어져 있어 스키마가 서로 다름
• 리콜 + TSB + 불만을 한 곳에서 가져올 방법이 없음

Vehicle Finder API는 이러한 모든 데이터를 일관된 REST API로 정규화하고, 적절한 JSON 응답, API‑키 인증, 속도 제한을 제공합니다.

전체 예제 (Python)

import requests

API_KEY = "vda_your_key_here"
BASE = "https://api.vehicle-finder.com/v1"

# Decode a VIN
vin = "1HGCM82633A004352"
vehicle = requests.get(f"{BASE}/vehicles/vin/{vin}",
    headers={"X-API-Key": API_KEY}).json()

print(f"Vehicle: {vehicle['data']['year']} {vehicle['data']['make']} {vehicle['data']['model']}")

# Get recalls
recalls = requests.get(f"{BASE}/recalls?vin={vin}",
    headers={"X-API-Key": API_KEY}).json()

for recall in recalls["data"]:
    print(f"Recall: {recall['component']}: {recall['summary']}")

또 무엇을 조회할 수 있나요?

리콜 외에도 API가 제공하는 기능:

• 오일 교환 사양 – 종류, 용량, 필터 부품 번호
• 정비 일정 – 제조사 권장 주기
• 진단 코드 – OBD‑II DTC 설명 및 일반적인 해결 방법
• TSB – 제조사의 기술 서비스 게시물
• 소비자 불만 – NHTSA에서 수집한 충돌/화재/부상 보고서
• 토크 사양, 견인 용량, 유체 사양 등 다양한 정보

시작하기

1. vehicle-finder.com 에서 회원가입 (무료, 월 500 요청)
2. 이메일 인증
3. 대시보드에서 API 키 생성
4. 요청을 시작하세요

전체 문서: api.vehicle-finder.com/docs

제가 직접 프로젝트에 필요해서 만들었고, 다른 개발자들도 도움이 될 것이라 생각했습니다. 무료 티어는 실제로 유용합니다—월 500 요청이면 사이드 프로젝트나 프로토타입을 만들기에 충분합니다. 피드백 환영합니다!