{"openapi":"3.0.3","info":{"title":"APICK 차종별 차량정보 조회","version":"1.0.0","description":"브랜드·차명·연식·등급으로 해당 차종의 제원·사양·등급 정보를 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/vehicle_model_info":{"post":{"summary":"차종별 차량정보 조회","description":"브랜드·차명·연식·등급으로 해당 차종의 제원·사양·등급 정보를 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"차종":{"type":"object","properties":{"제조사":{"type":"string"},"그룹":{"nullable":true},"차명":{"type":"string"}},"description":"찾은 차종 {제조사, 그룹, 차명}. 그룹은 모회사가 따로 있는 브랜드만(예: 렉서스 → 도요타)"},"제원":{"type":"object","properties":{"제조사":{"type":"string"},"차명":{"type":"string"},"연식":{"type":"integer"},"등급":{"type":"string"},"배기량":{"type":"integer"},"연료":{"type":"string"},"복합연비":{"type":"integer"},"전장":{"type":"integer"},"전륜타이어":{"type":"string"},"등급후보":{"type":"array","items":{"type":"object","properties":{"연식":{"type":"integer"},"등급":{"type":"string"}}},"description":"등급을 하나로 정하지 못했을 때의 후보 [{연식, 등급}]. 정했으면 항목이 없습니다."},"제원기준일":{"type":"string","description":"제원을 마지막으로 갱신한 시각"},"사양":{"type":"object","description":"등급의 기본·선택 사양 목록 {기본: [...], 선택: [...]}. 없으면 항목이 없습니다."}},"description":"제조사·차명·연식·등급과 값이 있는 제원 항목. 값이 없는 항목은 싣지 않습니다. 값은 표준 표기로만 내려갑니다(연료: 가솔린·디젤·LPG·전기·수소·하이브리드, 차체형상: 세단·SUV·MPV 등, 구동방식: 전륜·후륜·2WD·AWD, 변속기: 자동 8단·DCT 7단·CVT, 에너지효율등급: 1~5등급). 여러 값은 + 로 잇습니다(예: 가솔린+디젤, 후륜+AWD). 배기량, 연료, 차체형상, 변속기, 변속기단수, 엔진형식, 구동방식, 최고출력, 최대토크, 승차정원, 전장, 전폭, 전고, 축거, 공차중량, 복합연비, 도심연비, 고속도로연비, 에너지효율등급, 이산화탄소배출량, 연간유류비, 전기주행거리, 배터리용량, 배터리종류, 충전시간, 완속충전시간, 급속충전시간, 최고속도, 가속시간, 휠크기, 전륜타이어, 후륜타이어, 전륜타이어규격, 후륜타이어규격, 전륜서스펜션, 후륜서스펜션, 전륜브레이크, 후륜브레이크, 연료탱크용량, 배터리규격, 운전석와이퍼, 조수석와이퍼, 엔진오일용량, 엔진오일점도, 보증기간, 보증거리, 정비주기, 판매가격"},"success":{"type":"integer","description":"과금 여부0: 실패 또는 무료 응답1: 성공"},"안내":{"type":"string","description":"추천을 함께 돌려줄 때, 또는 입력한 등급과 같은 등급의 제원이 없어 기본 제원으로 답할 때의 설명 문구. 정확히 일치했으면 항목이 없습니다."},"추천":{"type":"object","properties":{"입력":{"type":"object","properties":{"제조사":{"type":"string"},"차명":{"type":"string"},"연식":{"type":"integer"},"등급":{"nullable":true}}},"자동선택":{"type":"boolean"},"대안":{"type":"array","items":{"type":"object","properties":{"제조사":{"type":"string"},"차명":{"type":"string"},"유사도":{"type":"number"},"제원있음":{"type":"boolean"},"연식":{"type":"array","items":{"type":"integer"}},"등급":{"type":"array","items":{"type":"string"}}}}}},"description":"차명·등급 표기가 정확히 일치하지 않을 때의 추천입니다. {입력: {제조사, 차명, 연식, 등급}, 자동선택: Boolean, 대안: Array}. 자동선택이 true면 그 차종의 제원을 함께 돌려주었고, false면 제원 없이 대안만 알려줍니다(무료). 대안은 유사도가 높은 순서의 [{제조사, 차명, 유사도, 제원있음, 연식, 등급}] 입니다. 유사도는 0~1 이고 제원있음이 false면 그 차종의 제원이 아직 없는 것입니다. 정확히 일치했으면 항목이 없습니다."}},"description":"조회 데이터"},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer"},"ms":{"type":"integer"},"pl_id":{"type":"integer"}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":false,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"maker":{"type":"string","description":"브랜드. 예: 현대, 기아, BMW, 렉서스 (string)","example":"기아"},"model":{"type":"string","description":"차명. 예: 아반떼, 더 뉴 K5, 520i. 비우면 차종 목록 (string)","example":"더 뉴 K5"},"modelYear":{"type":"string","description":"연식(4자리). 예: 2024 (string)","example":"2023"},"trim":{"type":"string","description":"등급·트림. 예: 프레스티지 (string)"}}}}}}}}},"x-code-tables":[],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}