자동차종합정보 첨부형API

이용가이드

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

1	자동차종합정보 API 사용 업무 흐름도

□ 자동차종합정보 첨부형API 업무처리 흐름도(사업용차량 이력정보 포함)

2	업무처리 상세내용

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

① 자동차종합정보·사업용차량이력 API 이용신청

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

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

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

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

※ 데이터 열람을 원할 경우 자동차종합정보 개방플랫폼 이용(한국데이터산업진흥원 내 데이터프리존)

- 데이터 신청 예시

구분

내용

공공데이터 명

예시) 자동차종합정보 첨부형API

자동차종합정보 사업용차량 이력정보 API

공공데이터 내용

제공 받고자 하는 데이터가 포함되어 있는 그룹명·항목 명시

1. 자동차종합정보 첨부형API 기본, 제원1, 제원2, 정비이력, 성능1, 성능2 전체6종(전체 또는 그룹별 선택 가능)

2. 자동차종합정보 첨부형API 소유주변경이력정보(Y/N값 제공) 1개 항목

3. 사업용차량 이력정보 API(8종) 기본, 검사이력, 정비이력, 성능점검이력, 의무보험 가입여부, 체납 횟수, 압류 건수, 저당권등록 건수 전체 8종(전체 일괄제공)

데이터 활용 목적

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

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

※旣 서비스 운영기업에서는 추가로 제공 받고자하는 데이터가 있을 경우 별도의 추가신청이 필요

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

※ 데이터 항목은 자동차 기본정보, 제원정보1, 제원정보2, 정비이력, 성능점검정보1, 성능점검정보2로 구성되어 있으며 소유주 변경이력은 별도 항목(API)으로 구분하여 신청

사업용차량 이력정보 API 서비스 항목(전체 8종/소유주 미동의)

제공 항목	제공값(예시)
자동차기본정보	자동차등록번호(969샘7218), 차량명(금팔식 추럭), 차종코드명(화물), 용도구분명(영업용), 양도일자(20231002), 차량등록일자(20011227)
자동차검사이력	차량등록번호(969샘7218), 검사순서(1,2,3), 검사구분명(정기검사), 검사일자(20140105, 20150515)
정비이력	차량등록번호(969샘7218), 정비횟수(40)
성능점검 이력	차량등록번호(969샘7218), 성능점검회수(4)
의무보험 가입여부	차량등록번호(969샘7218), 의무보험가입여부(N)
체납 횟수	차량등록번호(969샘7218), 체납횟수(10)
압류 건수	차량등록번호(969샘7218), 압류건수(15)
저당권등록 건수	차량등록번호(969샘7218), 저당건수(21)

※ 데이터 항목은 자동차 기본정보, 검사이력, 정비이력, 성능점검 이력, 의무보험 가입여부,

체납 횟수, 압류 건수, 저당권등록 건수로 구성되어 있으며 전체 항목을 일괄 신청 및 제공

② API 이용신청 항목, 목적 등을 검토 후 심사 결과 통보

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

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

- 담당자 : 한국교통안전공단 자동차정보처 손교정과장, 박나율주임

- E-mail : gjson@kotsa.or.kr(손교정) /sora9413@kotsa.or.kr(박나율)

- 전화번호 : 054-459-7492, 7512

※ 공공데이터포털 신청상세정보에는 신청인의 개인정보(전화번호, 이메일) 마스킹으로 제공받는자의 정보 식별이 불가능하여, 신청인이 공단 담당자에게 문의 필요(必)

④ 차량 소유자의 제3자 정보제공 동의 본인인증 수행 환경 조성

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

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

- 서비스 가입 후 제공받은 코리아크레딧뷰로(주) 라이선스파일을 공단으로 제출(문서24 docu.gdoc.go.kr) / 타사 본인확인서비스 사용 불가

※ 데이터 호출 차량이 개인 소유일 경우 차량소유주의 제3자 정보제공동의가 필요하며, 반드시 공단에서 제공하는 인증페이지를 통하여 인증하여야 함

구분	담당	성명	전화번호	이메일	비고
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_서비스 항목(전체)

ㅇ 자동차기본정보는 필수 제공하고 그 외 정보(그룹)는 제공승인결정된 범위 內 항목(그룹)에 한하여 선택하여 신청 가능

⑤ 행정서류 작성

- 이용 신청자는 공공데이터포털을 통해 공공데이터 결정통보서를 다운로드 받아 공단 업무 담당자 e-mail로 원본 파일 제출

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

- 공단은 국토부의 자료제공 협조 요청(공문)에 따라 신청인에게 행정서류 안내

- 신속한 행정절차 진행을 위해 공문으로 서류 제출 전 공단 담당자에게 메일 전송 후 사전 검토 필수

-  이용 신청자(기업)의 제출 서류는 ‘문서24(docu.gdoc.go.kr)를 통하여 제출

※ 공문 수신처(기관) : 한국교통안전공단

※ 제출서류 : 이용신청서, 공공데이터 제공결정통보서(원본), 이행확약서(안전관리 대책), 첨부형API신청서, 방화벽허용신청서, KCB라이선스파일, 법인등기부등본, 사업자등록증, 재직증명서 각 1부

⑥ 첨부형API 신청서 및 방화벽 정책 허용 신청서 제출(엑셀양식)

- 데이터 호출에 필요한 API 인증키, 인증서 발행 등을 위해 기업정보를 시스템에 등록함(제공하는 양식에 맞춰 작성 후 공문으로 제출)

※ 관련된 양식은 행정절차 안내 시 메일로 별도 제공(방화벽신청서, 첨부형API 신청서)

⑦ 차량 소유자의 제3자 정보제공 동의 본인 인증 절차

- 공단에서 제공하는 인증페이지에서 차량 소유주의 성명, 자동차등록번호를 입력하고 휴대폰으로 인증하여 소유자의 본인확인 수행

- 제3자 정보제공 동의는 [붙임1]의 상세 설명 참조

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

⑧ 이용신청자는 서류 제출 및 시스템 등록 완료 후 발행된 인증키를 기반으로 자체 개발 후 API 호출

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

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

const form = document.createElement('form');

form.method = 'POST';

form.action = 'https://biz.car365.go.kr/bzpt/task/lnkh/kcbCert/kcbOkCert.do'; // 요청할 주소

form.target = 'popupWindow'; // 새 창 이름

// 전송할 데이터 추가

//input1 공단에 등록 신청한 엑셀 양식을 통해 제공받는 API키

const input1 = document.createElement('input');

input1.type = 'hidden';

input1.name = 'apiKeyArr';

input1.value = 'AAAAAAAA-BBBBBBBB-CCCCCCCC-DDDDDDDD, EEEEEEEE-FFFFFFFF-GGGGGGGG-HHHHHHHH';

form.appendChild(input1);

//input2 소유주명

const input2 = document.createElement('input');

input2.type = 'hidden';

input2.name = 'carOwner';

input2.value = '테스트사용자';

form.appendChild(input2);

//input3 차량번호

const input3 = document.createElement('input');

input3.type = 'hidden';

input3.name = 'carRegNo';

input3.value = '111가2222';

form.appendChild(input3);

//input4 고정방식 Y / 비고정방식 N

const input4 = document.createElement('input');

input4.type = 'hidden';

input4.name = 'svcType';

input4.value = 'Y';

form.appendChild(input4);

// 새 창(popup) 열기

window.open('', 'popupWindow', 'width=600,height=400');

// form body에 붙이고 전송

document.body.appendChild(form);

form.submit();

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

- 기관명_첨부형API.xlsx : 서비스별 API Key 제공(API Key는 영문숫자혼합 32자리 코드이며, 다건의 서비스를 이용할 경우 ',' 구분기호로 추가해서 동시에 여러개 서비스에 적용 가능)

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

- 제공동의 저장 완료 시 returnURL 파라미터에 URL이 있을 경우 해당 URL로 GET방식으로 호출하며, URL이 없을 경우 팝업창이 닫힘

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

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

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

③ 본인인증 정보입력

PC 버전	모바일 버전

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

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

PC 버전	모바일 버전

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

④-1 PASS앱 인증

PC 버전	모바일 버전

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

본인 인증 완료 시	returnURL 파라미터에 URL이 있을 경우 → 해당 URL로 GET방식으로 호출	저장 완료 시 get방식으로 성공 리턴URL (returnURL)로 요청
	returnURL 파라미터에 URL이 없을 경우 → 팝업창이 닫힘
본인 인증 실패 시	오류 팝업 출력

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

❶ 신청인(기업) 정보 입력

❷ 업무담당자 및 회사정보 입력

❸ 신청하는 항목 모두 체크

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

➋ 신청인 또는 기업의 업무 담당자 정보를 기재하며 전자우편은 업무 담당자의 이메일을 입력

➌ 제공결정된 데이터 항목 범위 내에서 제공 받고자 하는 데이터를 선택하여 체크

➍ 날짜는 제출하는 날짜를 기재하고, 신청인(기업 대표자)의 서명 또는 날인 후 해당 서류를 문서24로 통해 공문으로 제출

붙임3		자동차종합정보 첨부형API 개방항목( 6개 그룹 )

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