{"openapi":"3.0.3","info":{"title":"APICK 자동차세 계산","version":"1.0.0","description":"배기량과 차령으로 비영업용 승용자동차의 연간 자동차세와 지방교육세를 계산합니다. 차량을 등록하거나 보유 차량의 세금을 미리 확인할 때 씁니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/vehicle_tax_calc":{"post":{"summary":"자동차세 계산","description":"배기량과 차령으로 비영업용 승용자동차의 연간 자동차세와 지방교육세를 계산합니다. 차량을 등록하거나 보유 차량의 세금을 미리 확인할 때 씁니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"result":{"type":"object","properties":{"year":{"type":"integer","description":"과세연도입니다."},"cc":{"type":"integer","description":"입력한 배기량입니다."},"cc_rate":{"type":"integer","description":"적용한 1cc당 세액(원)입니다."},"car_age_years":{"type":"integer","description":"계산에 쓴 차령(년)입니다."},"discount_rate":{"type":"integer","description":"차령 경감률(%)입니다. 3년 미만은 0입니다."},"vehicle_tax":{"type":"integer","description":"경감을 반영한 자동차세(원)입니다."},"local_education_tax":{"type":"integer","description":"지방교육세(원)입니다."},"total":{"type":"integer","description":"자동차세와 지방교육세의 합계(원)입니다."}}}}},"api":{"type":"object","properties":{"cost":{"type":"integer","description":"차감된 포인트입니다. 실패하면 0 입니다."},"success":{"type":"boolean"},"ms":{"type":"integer"}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"cc":{"type":"string","description":"배기량(cc)입니다. 50~10000 사이 정수입니다. 쉼표는 무시합니다(예: 1,998). (integer)","example":"1998"},"car_age_years":{"type":"string","description":"차령(년)입니다. 0~40 사이 정수이며 생략하면 0으로 계산합니다. 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (integer)","example":"5"},"year":{"type":"string","description":"조회할 연도(4자리)입니다. 서비스별 지원 범위를 확인하세요. (integer)"}},"required":["cc"]}}}}}}},"x-code-tables":[{"title":"오류 코드","columns":["error_code","의미","대처"],"rows":[["INPUT_REQUIRED","cc를 보내지 않았습니다.","배기량을 넣어 다시 요청합니다."],["INPUT_INVALID","숫자가 아니거나 허용 범위를 벗어났습니다.","cc 50~10000, car_age_years 0~40, year 2000~2026 범위의 정수로 보냅니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}