66,619 models · 4,365 series · 549 brands · VIN prefix + full parameter sheets · data updated 2026-10-15

API 연동

EV Manual 데이터를 진단 장비, 정비소 관리 시스템 또는 전자상거래 플랫폼에 통합하세요. 파트너 서비스는 세 가지 형태로 제공됩니다——제품에 맞는 것을 선택하세요:

형태적합한 용도작동 방식
JS 위젯 임베드웹사이트, 딜러 포털두 줄의 JavaScript로 임의의 페이지에 VIN 디코딩과 매뉴얼 검색 상자를 임베드합니다. 세션과 결제는 저희가 처리합니다.
REST API진단 도구, 관리 시스템HMAC 요청 서명이 있는 HTTPS JSON 엔드포인트. 종량제 과금, 사용량에 따라 조정되는 속도 제한.
화이트라벨 CNAME딜러 그룹, 플랫폼완전한 기술 데이터 센터가 자체 서브도메인(예: data.yourbrand.com)에서 자체 로고와 색상으로 실행됩니다.

데이터 도메인

API는 네 가지 데이터 도메인——VIN 디코딩, 사양표, 정비 매뉴얼, 배선도 및 DTC 조회——을 공개하며, 모든 응답에는 웹 인터페이스와 동일한 매치 레벨 메타데이터가 포함됩니다. 따라서 통합사는 추가 로직 없이 최종 사용자에게 신뢰도 정보를 표시할 수 있습니다.

도메인내용
VIN 디코딩17자리 VIN → 제조사, 시리즈, 차종 버전, 엔진/모터, 변속기, 섀시. 정확한 프리픽스와 WMI 폴드백 레벨.
사양표차종 버전당 완전한 공장 파라미터——치수, 중량, 엔진, 배터리, 타이어, 용량.
정비 매뉴얼차종별 공장 정비 매뉴얼——전체 문서 잠금 해제 전에 목차와 개요 검색 가능.
배선도 & DTC부품 오버레이가 있는 회로도, 그리고 고장 코드 정의/원인/수리 제안.

인증 및 과금

모든 요청은 API 키 페어와 타임스탬프 및 요청 본문을 커버하는 HMAC-SHA256 서명으로 인증되므로 재생 공격과 무단 사용을 방지합니다. 과금은 종량제입니다. 호출은 계량되어 토큰 잔액에서 차감되며, 사용량 티어가 커지면 단가가 자동으로 낮아집니다.

통합 가이드

일반적인 통합에는 1~5개 근무일이 소요됩니다: 물리 계정을 등록하고, 파트너십 페이지에서 테스트 크레덴셜을 요청한 뒤, 알려진 VIN으로 샌드박스 엔드포인트를 호출해 서명 흐름을 검증합니다. 예를 들어 2019 Toyota Camry의 VIN을 디코딩하면 차종 버전, 8문자 VIN 프리픽스, 사양표 링크가 하나의 JSON 응답으로 반환됩니다.

  1. /shop/register.html에서 물리 계정 등록——이것이 결제 ID가 됩니다.
  2. 파트너십을 통해 크레덴셜 요청. 테스트 키는 1영업일 이내에 발급됩니다.
  3. timestamp + method + path + body로 HMAC-SHA256 요청 서명. Python 및 JavaScript 참조 서명 구현을 제공합니다.
  4. 샌드박스 베이스 URL만 바꾸면 런칭. 사용량은 웹 상점과 동일한 토큰 월렛으로 계량됩니다.

대부분의 파트너는 세 개의 참조 VIN——정확한 프리픽스 매치 1개, WMI 폴드백 1개, 브랜드 수준 후보 1개——으로 통합을 검증합니다. 이 세 가지 경우가 디코더가 취할 수 있는 모든 코드 경로를 실행하기 때문입니다.

사용 사례

현재 통합 사례로는: 스캔 전에 VIN을 디코딩하는 유럽의 진단 장비 제조사, 등록된 부품을 차종 버전에 매칭하는 부품 마켓플레이스, 화이트라벨 CNAME으로 전체 데이터 센터를 운영하는 딜러 그룹이 있습니다. 어떤 경우든 통합 면은 동일하고 결제 프로파일만 다릅니다. 데이터 신선도도 공개 사이트와 동일합니다. API 응답은 2026-10-15에 업데이트된 동일한 데이터 세트에서 제공되기 때문입니다.

샌드박스 및 테스트

모든 통합은 물리 샌드박스에서 시작됩니다. 샌드박스는 프로덕션과 동일한 데이터 형상을 갖지만 고정된 참조 VIN 세트로 응답하므로, 단 한 개의 토큰도 쓰지 않고 구축과 테스트를 할 수 있습니다. 또한 샌드박스는 프로덕션과 동일한 매치 레벨 메타데이터를 반환하므로, 신뢰도 표시 로직은 런칭 전에 실제 폴드백 사례에 대해 테스트됩니다.

자주 묻는 질문

API 통합에는 얼마나 걸리나요?
대부분의 통합은 1~5영업일 안에 런칭됩니다. 샌드박스는 1영업일 이내에 테스트 크레덴셜을 발급하며 Python 및 JavaScript 참조 서명 구현도 제공합니다.
과금은 호출당인가요, 월정액인가요?
호출당이며 토큰 잔액에서 차감됩니다. 월간 사용량이 커지면 사용량 티어가 단가를 자동으로 낮추며, 사용하지 않은 토큰은 만료되지 않습니다.
결제 전에 API를 테스트할 수 있나요?
네. 테스트 크레덴셜은 물리이며 제한된 VIN 세트의 샌드박스에서 작동합니다. 프로덕션 베이스 URL로 전환할 때만 토큰 소비가 시작됩니다.
토큰 잔액이 떨어지면 어떻게 되나요?
API는 침묵하는 실패 대신 명확한 잔액 오류를 반환하며, 충전 후 프로덕션 트래픽이 자동으로 재개됩니다——재설정이 필요 없습니다.
API 액세스 신청 먼저 물리 계정 만들기