{"openapi":"3.0.3","info":{"title":"APICK 차량 공적 확인 묶음","version":"1.0.0","description":"vehicle_recall, hipass_unpaid, vehicle_tax_calc 을(를) 한 번의 요청으로 함께 조회합니다. 구성원마다 결과가 성공·실패로 나뉘어 돌아옵니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/data_result_vehicle_identity_bundle":{"post":{"summary":"차량 공적 확인 묶음","description":"vehicle_recall, hipass_unpaid, vehicle_tax_calc 을(를) 한 번의 요청으로 함께 조회합니다. 구성원마다 결과가 성공·실패로 나뉘어 돌아옵니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"success":{"type":"boolean","description":"성공한 구성원이 하나 이상이면 true 입니다."},"product":{"type":"string","description":"묶음 상품 코드(vehicle_identity_bundle)"},"members":{"type":"array","items":{"type":"string"},"description":"이 묶음에 담긴 구성원 코드 목록입니다."},"results":{"type":"object","properties":{"vehicle_recall":{"type":"object","properties":{}},"hipass_unpaid":{"type":"object","properties":{}},"vehicle_tax_calc":{"type":"object","properties":{}}},"description":"성공한 구성원의 응답 본문. 구성원 코드를 키로 담깁니다."},"failures":{"type":"object","properties":{"hipass_unpaid":{"type":"string"}},"description":"실패한 구성원의 오류. 구성원 코드를 키로, 안내 문구를 값으로 담습니다. 실패가 없으면 빈 객체 {} 입니다."}}},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"성공한 구성원이 하나 이상이면 true 입니다."},"cost":{"type":"integer","description":"API 호출 요금"},"ms":{"type":"integer","description":"API 응답 시간"},"pl_id":{"type":"integer","description":"API 결제 로그 ID"}},"description":"API 호출 공통 데이터"}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":false,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"car_no":{"type":"string","description":"차량번호입니다. 리콜·하이패스 미납 조회에 씁니다. 예: <code>12가3456</code> (string)","example":"…"},"vin":{"type":"string","description":"차대번호 17자입니다. 리콜 조회에 쓰며 <code>car_no</code>와 함께 보내지 않습니다. (string)","example":"…"},"cc":{"type":"string","description":"배기량(cc, 50~10000)입니다. 자동차세 계산에 씁니다. 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (integer)","example":"…"},"car_age_years":{"type":"string","description":"차령(년, 0~40)입니다. 자동차세 계산에 씁니다. 생략하면 0으로 계산합니다. (integer)","example":"…"}}}}}}}}},"x-code-tables":[{"title":"오류와 복구","columns":["상황","HTTP","오류 코드","해결"],"rows":[["구성원 일부가 실패","200","— (failures.<구성원>에 오류 문구)","성공한 구성원 결과는 그대로 받고, 실패한 구성원의 입력을 확인해 다시 요청합니다."],["구성원 전부가 실패","200","— (success: false)","failures 의 안내를 확인해 입력을 고친 뒤 다시 요청합니다."],["이 묶음을 이용할 수 없는 상태","503","NATIVE_BUNDLE_UNAVAILABLE","잠시 뒤 다시 요청합니다. 이 상품을 계속 쓸 수 없으면 문의게시판으로 알려주세요."],["서버 처리 오류","500","NATIVE_BUNDLE_FAILED","잠시 뒤 다시 요청합니다. 반복되면 문의게시판으로 알려주세요."],["/rest/req_<묶음> 으로 호출","400","NATIVE_BUNDLE_NO_AUTH","이 묶음은 인증요청 단계가 없습니다. /rest/data_result_vehicle_identity_bundle 로 요청합니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}