■ [별첨] 연계 인터페이스 설명서

시군구 자동차기본사항조회 (SignguCarBassMatterInqireService)

- 보유기관 : 국토교통부 자동차운영보험과

- 보유기관 인증서 : SVR1500000015

- 서비스 호출 URL : http://${행공_APIG_IP_ADDR}:${포트}/piss/api/molit/SignguCarBassMatterInqireService

▶ Http Header 정보

키	필수여부	설명	예시
Host	○	APIG 호스트 정보 입력 - (행정망)운영 : 10.188.225.25:29001 - (행정망)개발 : 10.188.225.94:29001 - (인터넷망)운영 : 116.67.73.153:29001 - (인터넷망)개발 : 116.67.73.153:39001, 116.67.73.153:39011	${APIG_IP_ADDR}:${포트}
Accept	○	Content-Type의 값과 동일하게 기재	text/xml
Content-Type	○	본문의 미디어 타입 기재 ※데이터 포맷이 JSON일 시 application/json을, 데이터 포맷이 XML일 시 application/xml을 기재	text/xml; charset=utf-8
api_key	O	행정정보공동이용 서비스 신청하면 발급되는 api key 사용	abcdefghijklmnopqrstuvwxyz0123456789
cert_server_id	O	이용기관 GPKI 인증서 ID gpki_yn=Y 일 때, 응답메시지 certServerId로 암호화 됨.	SVR1311000030
tx_id	O	yyyyMMddHHmmssSSS+랜덤키젠8자리 트랜잭션 유니크 아이디로 서비스 추적에 사용	20230522164635410PMszB1j5
gpki_yn	X	GPKI 인증서를 이용한 암복호화 사용여부 gpki_yn=Y 일 때, certServerId 필수로 입력.	Y, N
cvmis_apikey	O	차세대 교통안전공단에서 발급하는 key	1234AAAA-A1324567-A1234567-A1234567

HttpURLConnection으로 호출 시 Header값 세팅 예시

▶ 송수신 인터페이스

코드명		항목	타입	크기	필수 여부	비고
송신(요청) Message
INFO_SYS_ID		정보시스템ID		6
INFO_SYS_IP		정보시스템IP		23
SIGUNGU_CODE		시군구코드		5
CNTC_INFO_CODE		연계정보코드		10
CHARGER_ID		담당자ID		15
CHARGER_IP		담당자IP		23
CHARGER_NM		담당자명(사용자)		50
LEVY_STDDE		부과기준일		8
INQIRE_SE_CODE		조회구분코드		1
VHRNO		자동차등록번호		16
VIN		차대번호		17
수신(응답) Message
CNTC_RESULT_CODE		연계결과코드		8
CNTC_RESULT_DTLS		연계결과상세		200
record		List	List
	PRYE	연식		4
	REGIST_DE	등록일(변경일)		8
	ERSR_REGIST_SE_CODE	말소등록구분코드		4
	ERSR_REGIST_SE_NM	말소등록구분명		0
	ERSR_REGIST_DE	말소등록일		8
	REGIST_DETAIL_CODE	등록상세코드		3
	DSPLVL	배기량		6
	USE_STRNGHLD_LEGALDONG_CODE	사용본거지법정동코드		10
	USE_STRNGHLD_ADSTRD_CODE	사용본거지행정동코드		10
	USE_STRNGHLD_MNTN	사용본거지산		2
	USE_STRNGHLD_LNBR	사용본거지번지		4
	USE_STRNGHLD_HO	사용본거지호		4
	USE_STRNGHLD_ADRES_NM	사용본거지상세주소		150
	USE_STRNGHLD_ROAD_NM_CODE	사용본거지도로명코드		12
	USGSRHLD_UNDGRND_BULD_SE_CODE	사용본거지지하건물구분코드		1
	USE_STRNGHLD_BULD_MAIN_NO	사용본거지건물주요번호		5
	USE_STRNGHLD_BULD_SUB_NO	사용본거지건물부번호		5
	USGSRHLD_ADRES_FULL	사용본거지전체주소		500
	MBER_SE_CODE	대표소유자회원구분코드		2
	MBER_NM	대표소유자성명		50
	MBER_SE_NO	대표소유자회원번호		13
	TELNO	대표소유자전화번호		20
	OWNER_LEGALDONG_CODE	소유자법정동코드		10
	OWNER_ADSTRD_CODE	소유자행정동코드		10
	OWNER_MNTN	소유자산		2
	OWNER_LNBR	소유자번지		4
	OWNER_HO	소유자호		4
	OWNER_ADRES_NM	소유자상세주소		150
	OWNER_ROAD_NM_CODE	소유자도로명코드		12
	OWNER_UNDGRND_BULD_SE_CODE	소유자지하건물구분코드		1
	OWNER_BULD_MAIN_NO	소유자건물주요번호		5
	OWNER_BULD_SUB_NO	소유자건물부번호		5
	OWNER_ADRES_FULL	소유자전체주소		500
	AFTR_VHRNO	신차량번호		16
	USE_FUEL_CODE	사용연료코드		1
	PRPOS_SE_CODE	용도구분코드		2
	MTRS_FOM_NM	원동기형식명		50
	FRNT_VHRNO	이전차량번호		16
	VHRNO	차량번호		16
	VIN	차대번호		17
	CNM	차명		50
	VHCLE_TOT_WT	차량총중량		6
	CAAG_ENDDE	차령만료일자		8
	CHANGE_DE	차번호변경시기		8
	VHCTY_ASORT_CODE	차종종별코드		1
	VHCTY_TY_CODE	차종유형코드		1
	VHCTY_SE_CODE	차종분류코드		1
	MXMM_LDG	최대적재량		10
	VHCTY_ASORT_NM	차종종별명		100
	VHCTY_TY_NM	차종유형명		100
	VHCTY_SE_NM	차종분류명		100
	FRST_REGIST_DE	최초등록일		8
	FOM_NM	형식		50
	ACQS_DE	취득일자		8
	ACQS_END_DE	취득종료일자		8
	YBL_MD	제작년월일		8
	TRANSR_REGIST_DE	이전등록일(양수일)		8
	SPCF_REGIST_STTUS_CODE	제원등록상태코드		6
	COLOR_NM	색상명		50
	MRTG_CO	저당수		9
	SEIZR_CO	압류건수		9
	STMD_CO	구조변경수		9
	NMPL_CSDY_AT	번호판영치여부		1
	NMPL_CSDY_REMNR_DE	번호판영치최고일		8
	ORIGIN_SE_CODE	출처구분코드		1
	NMPL_STNDRD_CODE	번호판규격코드		1
	ACQS_AMOUNT	취득금액(최종/최초)		18
	INSPT_VALID_PD_BGNDE	검사유효기간시작일		8
	INSPT_VALID_PD_ENDDE	검사유효기간종료일		8
	USE_STRNGHLD_GRC_CODE	사용본거지관청코드		4
	TKCAR_PSCAP_CO	승차정원수		3
	SPMNNO	제원관리번호		17
	TRVL_DSTNC	주행거리		10
	FRST_REGIST_RQRCNO	최초등록접수번호		20
	VLNT_ERSR_PRVNTC_NTICE_DE	예고통지일		8
	REGIST_INSTT_NM	등록기관명		100
	PROCESS_IMPRTY_RESN_CODE	처리불가사유코드		2
	PROCESS_IMPRTY_RESN_DTLS	처리불가사유명세		50
	CBD_LT	차체길이		10
	CBD_BT	차체너비		10
	CBD_HG	차체높이		10
	FRST_MXMM_LDG	최초최대적재량		10
	FUEL_CNSMP_RT	연료소비율		5
	ELCTY_CMPND_FUEL_CNSMP_RT	전기복합연료소비율		5

▶ 행정전자서명을 이용한 메시지 보안

메시지 보안을 위해 메시지를 송신하기 전에 행정전자서명 인증관리센터에서 발급하는 GPKI 인증서(서버용) 및 행정표준보안 API를 이용하여 암호화 및 전자서명을 수행해야 한다. 반대로 메시지를 수신하면 전자서명을 검증하고 복호화를 수행해야 한다.

※ 보유기관 : 국토교통부 자동차운영보험과 (자동차관리정보시스템)

※ 보유기관 GPKI 인증서 ID : SVR1500000015

구분	절차
송신	평문(암호화전) → 암호화 → 전자서명 → BASE64 인코딩
수신	복호화 ← 전자서명 검증 ← BASE64 디코딩 ← 암호화문

▶ 요청 & 응답 메시지 샘플

요청 (보유기관 GPKI 인증서 ID로 암호화)

암호화 전 요청 메시지

{

"data": [

{

"CNTC_INFO_CODE": "",

"ONES_INFORMATION_OPEN": "",

"VHRNO": "",

"CPTTR_NM": "",

"CPTTR_IHIDNUM": "",

"CPTTR_LEGALDONG_CODE": "",

"ROUTE_SE_CODE": "",

"DETAIL_EXPRESSION": "",

"INQIRE_SE_CODE": ""

}

]

}

암호화 후 요청 메시지

MIIKtQIBATENMAsGCWCGSAFlAwQCATCCAmEGCSqGSIb3DQEHAaCCAlIEggJOMIICSgIBADGCAYQwggGAAgEAMGgwUDELMAkGA1UEBhMCS1IxHDAaBgNVBAoME0dvdmVybm1lbnQgb2YgS29yZWExDTALBgNVBAsMBEdQS0kxFDASBgNVBAMMC0NBMTMxMTAwMDAxAhR+x2kS5xyyB7PA2xx2PDLgpkYuwzANBgkqhkiG9w0BAQcw...

응답 (이용기관 GPKI 인증서 ID로 복호화)

복호화 전 응답 메시지

MIIKtQIBATENMAsGCWCGSAFlAwQCATCCAmEGCSqGSIb3DQEHAaCCAlIEggJOMIICSgIBADGCAYQwggGAAgEAMGgwUDELMAkGA1UEBhMCS1IxHDAaBgNVBAoME0dvdmVybm1lbnQgb2YgS29yZWExDTALBgNVBAsMBEdQS0kxFDASBgNVBAMMC0NBMTMxMTAwMDAxAhR+x2kS5xyyB7PA2xx2PDLgpkYuwzANBgkqhkiG9w0BAQcw...

복호화 후 응답 메시지

{

"data": [

{

"CNTC_RESULT_DTLS": "",

"record": [

{

"OWNER_ADRES_FULL": null,

"DSPLVL": null,

"MTRS_FOM_NM": null,

"REGIST_INSTT_NM": null,

"USE_STRNGHLD_BULD_MAIN_NO": null,

"TRANSR_REGIST_DE": null,

"STMD_CO": null,

"ERSR_REGIST_SE_CODE": null,

"VLNT_ERSR_PRVNTC_NTICE_DE": null,

"COLOR_NM": null,

"MBER_SE_CODE": null,

"OWNER_BULD_SUB_NO": null,

"PRPOS_SE_CODE": null,

"FRNT_VHRNO": null,

"VHCTY_SE_CODE": null,

"USGSRHLD_ADRES_FULL": null,

"PROCESS_IMPRTY_RESN_CODE": "",

"FRST_REGIST_DE": null,

"CBD_BT": null,

"ACQS_AMOUNT": null,

"OWNER_LNBR": null,

"OWNER_LEGALDONG_CODE": null,

"CHANGE_DE": null,

"OWNER_ADSTRD_CODE": null,

"REGIST_DE": null,

"PRYE": null,

"ERSR_REGIST_DE": null,

"MBER_SE_NO": null,

"USGSRHLD_UNDGRND_BULD_SE_CODE": null,

"CAAG_ENDDE": null,

"SPCF_REGIST_STTUS_CODE": null,

"INSPT_VALID_PD_BGNDE": null,

"CBD_HG": null,

"OWNER_ADRES_NM": null,

"VHCTY_ASORT_CODE": null,

"VHCTY_TY_CODE": null,

"VHCTY_ASORT_NM": null,

"MXMM_LDG": null,

"ORIGIN_SE_CODE": null,

"USE_STRNGHLD_MNTN": null,

"USE_STRNGHLD_LNBR": null,

"ACQS_DE": null,

"OWNER_ROAD_NM_CODE": null,

"TELNO": null,

"AFTR_VHRNO": null,

"FUEL_CNSMP_RT": null,

"SEIZR_CO": null,

"VHCTY_SE_NM": null,

"NMPL_STNDRD_CODE": null,

"CNM": null,

"PROCESS_IMPRTY_RESN_DTLS": "",

"FOM_NM": null,

"TKCAR_PSCAP_CO": null,

"TRVL_DSTNC": null,

"USE_STRNGHLD_ROAD_NM_CODE": null,

"ERSR_REGIST_SE_NM": null,

"MBER_NM": null,

"SPMNNO": null,

"USE_STRNGHLD_HO": null,

"CBD_LT": null,

"YBL_MD": null,

"USE_STRNGHLD_BULD_SUB_NO": null,

"MRTG_CO": null,

"USE_STRNGHLD_LEGALDONG_CODE": null,

"NMPL_CSDY_AT": null,

"FRST_REGIST_RQRCNO": null,

"FRST_MXMM_LDG": null,

"OWNER_MNTN": null,

"OWNER_BULD_MAIN_NO": null,

"VHCTY_TY_NM": null,

"OWNER_UNDGRND_BULD_SE_CODE": null,

"REGIST_DETAIL_CODE": null,

"USE_STRNGHLD_ADSTRD_CODE": null,

"ACQS_END_DE": null,

"INSPT_VALID_PD_ENDDE": null,

"USE_FUEL_CODE": null,

"USE_STRNGHLD_GRC_CODE": null,

"ELCTY_CMPND_FUEL_CNSMP_RT": null,

"USE_STRNGHLD_ADRES_NM": null,

"VIN": null,

"VHCLE_TOT_WT": null,

"OWNER_HO": null,

"VHRNO": null,

"NMPL_CSDY_REMNR_DE": null

}

],

"CNTC_RESULT_CODE": ""

}

]

}

▶ 행정정보공동이용 오류코드

서비스 수행 도중 오류가 발생한 경우 Body 태그 안에 Fault 태그를 이용하여 오류 내용을 표시한다.

※ 오류 발생 원인에 따라 굵은 부분의 내용은 달라질 수 있음

- service not found 오류 ... 호출 url 확인 필요

{

null=HTTP/1.1 404 Not Found, gpki_yn=Y, Host=10.188.225.94: 29001, Content-Length=3640, tx_id=202411051458461079ge9ORWA, cert_server_id=SVR1311000030, User-Agent=java-net-httpclient, Accept=application/json, Content-Type=application/json;charset=UTF-8, Cache-Control=must-revalidate,no-cache,no-store

}

- API-KEY 인증 오류 ... HTTP request Header의 api key 확인 필요

{

"code": 401,

"loc": "GATEWAY",

"message": "No authorized user found."

}

- 보유기관 target service 오류

{

"code": 502,

"loc": "PROVIDER",

"message": {

"errorMessage": "보유기관에서 오류가 발생하였습니다.",

"errorCode": "500042"

}

}