차량 매칭 API 가이드

🌐 서버 정보

Base URL: https://cardata.nodeplug.com

응답 형식: JSON

인증: 불필요

📡 API 엔드포인트

GET

https://cardata.nodeplug.com/api/v1/vehicle/search?car_number={차량번호}

설명: 차량번호를 입력받아 보험사 DB에서 가장 유사한 차량 1개를 반환합니다.

파라미터:

car_number (string, required): 차량번호 (예: "206거2414")

📋 응답 예시

✅ 성공 응답 (HTTP 200)

{
  "success": true,
  "car_number": "206거2414",
  "query_time": "2025-09-15T04:42:45.123456",
  "result": {
    "brand": "기아",
    "model": "NIRO",
    "name": "5인승 프레스티지,오토,에어컨,P/S,ABS,AIR-D,IM(하이브리드)",
    "year": "2024",
    "match_score": 1.149
  },
  "confidence": {
    "level": "high",
    "score": 0.9,
    "status": "exact_match",
    "message": "정확한 매칭을 찾았습니다."
  },
  "original_vehicle": {
    "brand": "기아",
    "model": "니로",
    "year": "2024"
  }
}

❌ 오류 응답 (HTTP 400)

{
  "success": false,
  "error": "invalid_car_number",
  "message": "유효하지 않은 차량번호입니다",
  "car_number": "잘못된번호",
  "query_time": "2025-09-15T04:42:45.123456"
}

📊 신뢰도 레벨

high 높음: 정확한 매칭 (브랜드, 모델, 연식 모두 일치)
medium 보통: 유사한 매칭 (브랜드 일치, 연식 차이 2년 이내)
low 낮음: 브랜드만 일치
very_low 매우낮음: 차선책 제안

🧪 실시간 테스트

아래 버튼을 클릭해서 실제 API를 테스트해보세요:

💻 사용 예시

JavaScript

async function searchVehicle(carNumber) {
  const response = await fetch(
    `https://cardata.nodeplug.com/api/v1/vehicle/search?car_number=${encodeURIComponent(carNumber)}`
  );
  const data = await response.json();
  
  if (data.success) {
    return data.result;
  } else {
    throw new Error(data.message);
  }
}

Python

import requests

def search_vehicle(car_number):
    url = "https://cardata.nodeplug.com/api/v1/vehicle/search"
    params = {"car_number": car_number}
    
    response = requests.get(url, params=params)
    data = response.json()
    
    if data["success"]:
        return data["result"]
    else:
        raise Exception(data["message"])

cURL

curl "https://cardata.nodeplug.com/api/v1/vehicle/search?car_number=206거2414"

⚠️ 주의사항

데이터 정확성: AI 매칭 결과이므로 100% 정확하지 않을 수 있습니다
차량 DB: 모든 차종이 보험사 DB에 있지 않을 수 있습니다
타임아웃: 응답 시간이 10초를 초과할 수 있습니다
Rate Limiting: 과도한 요청 시 제한될 수 있습니다

🚗 차량 매칭 API 가이드