자동차종합정보 첨부형API

이용가이드

	자동차운영보험과
	자동차정보처

1	첨부형 API 사용 업무 흐름도

□ 자동차종합정보 첨부형API 업무처리 흐름도

2	업무처리 상세내용

□ 자동차종합정보 첨부형API 업무처리 상세내용

① 첨부형API 이용신청

- 공공데이터포털 – 데이터요청 - 공공데이터 제공신청 - (중앙부처 및 공공기관) 제공신청서 작성

⦁ 기관명을 국토교통부로 설정하고 공공데이터 내용, 공공데이터 활용목적 등 상세히 기술

※ 데이터신청 시 항목 및 목적을 상세하게 적으셔야 되며, 검토가 불가한 경우 제공 반려처리 될 수 있음

공공데이터포털 메인화면	공공데이터 제공신청 화면

※ 데이터형태, 열람을 원할 경우 한국교통안전공단 자동차종합정보 개방플랫폼 이용

- 데이터신청 예시

구분

내용

공공데이터 명

자동차종합정보 첨부형API 자료

공공데이터 내용

제공받고자 하는 데이터 항목(상세항목 포함) 및 제공방식을 명시

자동차종합정보 첨부형API 기본, 제원 정보

* 별도항목 : 차대번호, 소유주 변경이력

* 기본정보 : 최초등록일, 사용연료명, 차종명, 모델연도, 취득금액 5개 항목

* 제원정보 : 제작국가명, 승차정원수, 차량중량, 제원관리번호 4개 항목

* 차대번호의 경우 소유자로부터 동의(체크)가 별도로 필요한 항목

데이터 활용 목적

제공받은 데이터를 활용하여 어떤 서비스 등 예정인지 목적 명시

수집되는 차량정보를 기반으로 자사 內 고객 중고차 시세 제공 서비스

※ 데이터수수료 등 산정을 위해 데이터항목은 명확하게 명시하여야 하며, ~등의 범위를 알 수 없는 표현은 보완필요 또는 반려처리 예정

※ 차대번호(’21.12), 소유주변경이력(’23.6), 최초취득금액(’24.7) 추가 개방

※ (주의사항) 旣 서비스 운영기관에서는 차대번호, 소유주변경이력, 최초취득금액, 필요시 별도의 추가신청이 필요하며, 기존 동의내역은 삭제 처리(API 킷값 재발행)

첨부형API_서비스 항목(전체)

※ 데이터 항목은 자동차 기본정보, 제원정보, 정비이력, 성능점검정보로 구성되어 있으며, 차대번호의 경우 별도 항목으로 공공데이터 내용에 차대번호를 추가하여 신청가능

② 첨부형API 이용신청 항목, 목적 등을 검토 후 검토‧승인 결과 통보

- 공공데이터포털을 통해 검토결과 통보서 확인

③ 국토교통부 승인 통보서를 기반으로 한국교통안전공단 담당자에게 시스템 연계를 위한 메일 또는 유선문의

- 담당자 : 한국교통안전공단 자동차정보처 손교정 과장

- E-mail : gjson@kotsa.or.kr

- 전화번호 : 054-459-7492

※ 공공데이터포털 결정통보서에는 개인정보(전화번호, 이메일) 마스킹으로 기관담당자 식별이 불가능하여, 꼭 공단 담당자에게 문의 필요

④ 제3자 정보제공동의 수행 환경 조성(휴대폰 본인인증서비스 가입)

- 코리아크레딧뷰로(주) 휴대폰 본인확인서비스 가입

※ 담당자 전화번호: 임진석 과장, 02-708-6393 / jsjs@koreacb.com

- 서비스가입 완료 시 첨부형API 제공기관 및 서비스코드 발행을 위해 양식파일 작성 및 코리아크레딧뷰로(주) 라이선스파일 제출

※ 정보제공을 받을 차량이 개인 소유일 경우 차량소유주의 제3자 정보제공동의가 필요하며, 제3자정보제공동의를 온라인으로 받기 위해서는 1. 본인인증, 2. 차량소유주 확인이 필요함

구분	담당	성명	전화번호	이메일	비고
1	계약	임진석 과장	02-708-6393	jsjs@koreacb.com	단가, 서비스 계약
2	서비스	노인성 프로	02-708-6394	is.noh@koreacb.com	회원사코드, 라이센스, 정산 문의
3	개발	강홍순 프로	02-708-6094	hs.kang@koreacb.com	서비스 관련 민원 및 개발 문의

㈜코리아크레딧뷰 본인확인 라이선스 확인 예시
	- 회원사코드 및 라이선스는 계약담당자 메일로 발송(계약체결 후) ※ 회원사코드 이후 라이선스 발송 - 라이선스 파일(예시) ※ 회원사코드_IDS_01_PROD_AES_license.dat - 첨부형API 킷값 발행을 위해 ㈜KCB의 라이선스 파일은 공단 담당자에게 제출 필요 ※ 라이선스 생성은 영업일 기준 2~3일 소요

첨부형API 신청서 양식_제공업체 기본정보

ㅇ 기업명, 설명 등 작성 필요

첨부형API 신청서 양식_서비스 기본정보

ㅇ 서비스명, 목적은 차량소유자가 보는 내용으로 자세한 설명 등 입력

ㅇ 서비스 담당자의 정보 입력(서비스 안내 등 활용)

첨부형API_서비스 항목(전체)

ㅇ 승인받은 항목은“1”로 표시하고, 미승인항목은 빈칸

⑤ 행정서류작성

- 이용신청자는 공공데이터포털을 통해 공공데이터 결정통보서를 다운받고 메일에 첨부파일로 첨부 후 공단 담당자에게 행정안내 메일 요청

※ 공단담당자 : gjson@kotsa.or.kr

- 이용신청자는 한국교통안전공단에서 제공하는 행정서류를 작성하고, 준비된 서류를 가지고 공단에 방문해야 함

※ 필요서류 : 이용약정서, 이용신청서, 국토교통부 공공데이터 승인 통보서, 안전관리 대책, 법인등기부등본, 법인인감증명서, 사업자등록증, 이용신청자 재직증명서 각 1부

⑥ 첨부형API 신청서 양식파일 시스템 등록

- 행정처리가 끝난 이후 API키값 발행 등을 위해 시스템 등록이 필요하며, 등록 시 필요한 별도의 양식파일 제출(공단→업무담당자)

※ 관련된 양식은 행정처리 이후 메일로 별도 제공(방화벽신청서, 첨부형API 신청서)

- 업무담당자는 양식파일(방화벽, 첨부형API신청서), ㈜코리아크레딧뷰로 라이선스 파일을 공단 담당자에게 제출

- 공단담당자는 제출 받은 파일로 시스템 등록

⑥-1 제3자 정보제공동의 절차

- 차량 소유주 확인은 입력되는 소유자 성명과 차량등록번호로 차량의 소유자 확인 수행

- 제3자 정보제공 동의는 첨부되는 붙임 화면을 통해 상세 설명

※ [붙임] 제3자정보제공동의 관련 화면

⑦ 발행된 제공기관 및 서비스 코드를 기반으로 이용신청자는 첨부형API 호출

※ 자동차종합정보 첨부형API 기술문서 1.0 참조

붙임1		제3자정보제공동의 관련 화면

① 관리기관 및 사용자 정보에 대한 파라미터 입력(예시)

- 파라미터의 정보는 첨부파일 (기관명_첨부형API.xlsx)에 정의된 내용을 사용

- KCB본인인증 화면에 표시될 회원사 URL(siteURL), 사이트명(siteName) 필요

- 기관명_첨부형API.xlsx : 제공기관 코드(insttCode), 서비스 코드 배열(svcCodeArr) 제공

- 고정방식일 경우에는 파라미터에 차량 소유자 이름(carOwner), 차량 등록번호(carRegNo)에 데이터가 입력되어야 정상적으로 진행 가능

② 첨부형 API본인인증서비스 이동 고정 방식에 대한 확인 버튼을 클릭 시 입력된 form 방식으로 서버에 전송하여 본인인증 페이지 호출(예시)

③ 새 창에 본인인증 페이지 호출

PC 버전	모바일 버전
PC 버전	모바일 버전

- 차량 소유자 이름 및 차량 등록번호를 사용자가 입력하고 휴대폰 인증 버튼을 눌러 본인인증을 진행

④ 본인인증 정보입력

PC 버전	모바일 버전

- 본인인증 정보 입력 시 앞에서 작성한 차량 소유자 이름과 입력된 이름이 불일치 할 경우 첨부형API 동의를 진행 할 수 없음

⑤ 문자로 전송된 인증번호 입력

PC 버전	모바일 버전

- 요청 시 인증 문자가 전송되지 않음으로 임의의 번호 6자리를 입력

⑤-1 PASS앱 인증

PC 버전	모바일 버전

⑥ 인증결과 확인 및 첨부형 API 동의

	저장 완료 시 get방식으로 성공 리턴URL (returnURLA)로 요청

⑦ 서비스를 선택하고 동의 버튼 선택 시 서비스 동의 내용 저장

붙임2		행정서식 이용신청서 및 이용약정서 작성 요령

➊ 기업 대표자 및 회사정보 입력이 필요하며, 법인 및 사업자 등록번호 같이 입력

➋ 업무담당자 및 업무담당자의 회사정보를 입력하며, 전자우편(이메일)의 경우 전자세금계산서 발행을 위해 수신 가능한 메일도 함께 입력

※(예) gjson@kotsa.or.kr (전자세금)

➌ 자동차전산자료 체크 및 기타란에 자동차종합정보 첨부형API 입력

➍ 날짜는 공단 담당자와 협의하여 정한 방문날짜를 입력하고, 회사대표 성함 및 서명(인) 날인 후 해당서류를 지참하여 방문

<<공통사항>>	<<법인 인감 지참하여 방문 가능시>>	<<법인 인감 지참하여 방문 불가능시>>
□ 약정번호, 계좌번호, 주소 등은 공단 담당자에게 문의 필요 * 담당자 054-459-7492 □ 이용약정서 체결날짜는 방문 날짜로 기입	➊ 방문가능날짜를 공단담당자와 협의 ➋ 이용약정서 작성을 위한 사업자등록증 上 기재된 주소, 기업명, 대표자명 제출(기업→공단) ➌ 공단에서 이용약정서류를 먼저 준비하고, 기업담당자 방문 시 약정 체결 추진	➊ 방문가능날짜를 공단담당자와 협의 ➋ 이용약정서 작성을 위한 사업자등록증 上 기재된 주소, 기업명, 대표자명 기입 * 공단 관련정보는 담당자에게 문의 ➌ 기업도장이 날인된 이용약정서를 준비하고, 해당서류를 지참하여 공단방문

붙임3		이용수수료 산정 방법

□ 자동차종합정보 첨부형API 이용수수료 산정 방법

ㅇ 자동차기본, 제원정보 수수료 산정(VAT별도)

수수료 식: [eqn: {노란색`선택`수```+`회색`선택`여부+초록색`선택여부(항목2개추가)+차대번호} over {20} ` TIMES `10]

* 차대번호 추가시, 항목 수에 + 1 하여 수수료 산정

* 녹색 : 1개 조회시에도 2개가 모두 표출됨에 따라 항목 2개를 모두 수수료로 산정

* 회색 : 검사유효기간은 시작, 종료를 하나의 항목으로 수수료 산정

* 예1) 최초등록일, 차종명, 차명 승인 받을 시, 차종유형명 추가 [eqn: {4} over {20} TIMES 10=2.0원]

* 예2) 최초등록일, 차종분류명, 차명 승인 받을 시 [eqn: {2} over {20} TIMES 10=1.0원]

* 예3) 최초등록일, 차명, 색상명, 검사유효기간시작･종료일 승인 받을 시 [eqn: {4} over {20} TIMES 10=2원]

ㅇ 성능점검, 정비이력의 경우 항목별 구분이 없어, 1개 항목 또는 전체 항목 승인 시 각각 40원

붙임4		자동차종합정보 첨부형API 개방항목

자동차기본	자동차제원1	자동차제원2	정비이력	성능점검1	성능점검2
최종처리일시	제작국가명	옵션적차전전축하중	정비이력_PK	접수관청코드	주행거리상태명
관할관청명	형식명	옵션적차전후축하중	정비차량_주행거리	접수일	튜닝항목구분명
등록관청명	차대차체형상명	옵션적차후전축하중	정비차량_등록연월일	접수순번	용도변경구분명
최초등록일	승차정원수	옵션적차후중축하중	정검정비의뢰일자	경정순번	단순수리여부
사용연료명	제작용도명	옵션적차후후축하중	정비사업자_사업자등록번호	성능점검_주행거리	가격조사산정업체명
차종명	차량중량	원동기최고출력값	정비사업자_업체명	계기작동여부	가격조사산정일
차종유형명	최대적재량	원동기RPM값	정비사업자_주소	성능점검_검사유효기간시작일	가격산정기준협회명
차종분류명	옵션최대적재량	원동기기통수값	정비사업자_전화번호	성능점검_검사유효기간종료일	색상여부
차명	차량총중량	원동기총배기량	정비사업자_점검정비완료일자	보증유형명	색상변경여부
색상명	차체길이	연료소비율	정비사업자_출고일자	불법구조변경	주요옵션차량지붕여부
용도구분명	차체너비	축간거리	추가정비동의여부	사고침수여부	주요옵션도로안내여부
용도상세구분명	차체높이	전윤간거리	정비이력_경정구분	자기진단사항_원동기	주요옵션기타여부
원동기형식명	옵션차체길이	후윤간거리	입력일시	자기진단사항_변속기	외장수리필요여부
취득금액	옵션차체너비	하대오프셋값	정비순번	배출가스매연측정값	내장수리필요여부
등록상세명	옵션차체높이	변속기종류명	작업내용	배출가스일산화탄수측정값	금속표면세척필요여부
모델연도	하대내부길이	변속기전진단수	부품구분명	배출가스탄화수소측정값	엔진방청소수리필요여부
제작자명	하대내부너비	변속기후진단수		점검업체명	림운전좌석전수리여부
제작일	하대내부높이	타이어전전형식		점검일	림운전좌석후수리여부
주행거리	옵션하대내부길이	타이어후전형식		고지업체명	림동반좌석전수리여부
검사유효기간시작일	옵션하대내부너비	전전축설계허용하중		매수일	림동반좌석후수리여부
검사유효기간종료일	옵션하대내부높이	전후축설계허용하중		성능점검_경정구분	림응급수리필요여부
점검유효기간시작일	공차시전전축하중	후전축설계허용하중		최종일자	타이어운전좌석전수리여부
점검유효기간종료일	공차시전후축하중	후중축설계허용하중		침수여부	타이어운전좌석후수리여부
말소등록일	공차시후전축하중	후후축설계허용하중		개정여부	타이어동반좌석전수리여부
말소등록구분명	공차시후중축하중	차대번호군		가격산정선택여부	타이어동반좌석후수리여부
폐차일	공차시후후축하중	모델년도기호코드			타이어응급수리필요여부
말소차량시도코드	옵션공차시전전축하중	모델년도			유리수리필요여부
말소완료여부	옵션공차시전후축하중	고속도로연료소비율			기본품목보유사용설명서여부
사용본거지법정동코드	옵션공차시후전축하중	시내연료소비율			기본품목보유삼받침여부
사용본거지행정동코드	옵션공차시후중축하중	전기복합연료소비율			기본품목보유공구여부
대표소유자회원번호	옵션공차시후후축하중	전기고속도로연료소비율			기본품목보유토크렌치여부
대표소유자회원구분명	적차전전축하중	전기시내연료소비율
최초취득금액	적차전후축하중	구동방식명
	적차후전축하중	제원관리번호
소유주 변경이력	적차후중축하중
차대번호	적차후후축하중

* 기본 제원정보의 수수료 부과 항목      상세 산정방식은 붙임3(이용수수료 산정 방법)을 참고

** 데이터프리존을 통해 위 데이터는 열람 가능하나, 열람가능항목과 제공가능항목은 차이가 있으며, 차대번호, 최초취득금액, 소유주변경이력 추가 개방

*** (주의사항) 旣서비스 운영기관에서는 차대번호 필요시 별도의 추가신청이 필요하며, 기존동의내역은 삭제 처리(API 킷값 재발행)