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

시군구 자동차등록원부(갑) (SignguCarLedgerFrmbkService)

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

- 보유기관 인증서 : SVR1500000015

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

▶ 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
INFO_SYS_IP		정보시스템IP
SIGUNGU_CODE		시군구코드
CNTC_INFO_CODE		연계정보코드
CHARGER_ID		담당자ID
CHARGER_IP		담당자IP
CHARGER_NM		담당자명(사용자)
VHRNO		자동차등록번호
ONES_INFORMATION_OPEN		개인정보공개
CPTTR_NM		민원인성명
CPTTR_IHIDNUM		민원인주민번호
CPTTR_LEGALDONG_CODE		민원인법정동코드
ROUTE_SE_CODE		경로구분코드
DETAIL_EXPRESSION		내역표시
INQIRE_SE_CODE		조회구분코드
수신(응답) Message
CNTC_RESULT_CODE		연계결과코드
CNTC_RESULT_DTLS		연계결과상세
LEDGER_GROUP_NO		원부그룹번호
LEDGER_INDVDLZ_NO		원부개별번호
VHMNO		차량관리번호
VHRNO		차량등록번호
VIN		차대번호
VHCTY_ASORT_CODE		차종종별코드
VHCTY_ASORT_NM		차종종별명
CNM		차명
COLOR_CODE		색상코드
COLOR_NM		색상명
NMPL_STNDRD_CODE		번호판규격코드
NMPL_STNDRD_NM		번호판규격명
PRPOS_SE_CODE		용도구분코드
PRPOS_SE_NM		용도구분명
MTRS_FOM_NM		원동기형식명
FOM_NM		형식명
ACQS_AMOUNT		취득금액
REGIST_DETAIL_CODE		등록상세코드
REGIST_DETAIL_NM		등록상세명
FRST_REGIST_DE		최초등록일
CAAG_ENDDE		차령종료일
PRYE		연식
SPMNNO1		제원관리번호1
SPMNNO2		제원관리번호2
YBL_MD		제작년월일
TRVL_DSTNC		주행거리
INSPT_VALID_PD_BGNDE		검사유효기간시작일
INSPT_VALID_PD_ENDDE		검사유효기간종료일
CHCK_VALID_PD_BGNDE		점검유효기간시작일
CHCK_VALID_PD_ENDDE		점검유효기간종료일
REGIST_REQST_SE_NM		등록신청구분명
FRST_REGIST_RQRCNO		최초등록접수번호
NMPL_CSDY_REMNR_DE		번호판영치최고일
NMPL_CSDY_AT		번호판영치여부
BSS_USE_PD		사업용사용기간
OCTHT_ERSR_PRVNTC_NTICE_DE		직권말소예고통지일
ERSR_REGIST_DE		말소등록일
ERSR_REGIST_SE_CODE		말소등록구분코드
ERSR_REGIST_SE_NM		말소등록구분명
MRTGCNT		저당수
VHCLECNT		압류건수
STMDCNT		구조변경수
ADRES1		사용본거지주소
ADRES_NM1		사용본거지주소상세
ADRES		소유자주소
ADRES_NM		소유자주소상세
INDVDL_BSNM_AT		개인사업자여부
TELNO		대표소유자전화번호
MBER_NM		대표소유자성명
MBER_SE_CODE		대표소유자회원구분코드
MBER_SE_NO		대표소유자회원번호
TAXXMPT_TRGTER_SE_CODE		비과세대상구분코드
TAXXMPT_TRGTER_SE_CODE_NM		비과세대상구분코드명
CNT_MATTER		특기사항건수
EMD_NM		사용본거지행정동명
PRVNTCCNT		예고수
XPORT_FLFL_AT_STTEMNT_DE		수출이행여부신고일
PARTN_RQRCNO		발급번호
FRST_TRNSFR_DE		최초양도일
PROCESS_IMPRTY_RESN_CODE		처리불가사유코드
PROCESS_IMPRTY_RESN_DTLS		처리불가사유명세
record		List	List
	MAINCHK	해제여부
	CHANGE_JOB_SE_CODE	변경업무구분코드
	MAINNO	주번호
	SUBNO	부번호
	DTLS	사항란
	RQRCNO	접수번호
	VHMNO	차량관리번호
	LEDGER_GROUP_NO	원부그룹번호
	LEDGER_INDVDLZ_NO	원부개별번호
	GUBUN_NM	변경업무구분명
	CHANGE_DE	변경일자
	DETAIL_SN	상세순번
	FLAG	표기여부

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

메시지 보안을 위해 메시지를 송신하기 전에 행정전자서명 인증관리센터에서 발급하는 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": [

{

"FRST_TRNSFR_DE": null,

"VHMNO": "",

"MTRS_FOM_NM": "",

"ERSR_REGIST_SE_CODE": "",

"COLOR_NM": null,

"CHCK_VALID_PD_BGNDE": null,

"TAXXMPT_TRGTER_SE_CODE": null,

"MBER_SE_CODE": "",

"PRPOS_SE_CODE": "",

"CHCK_VALID_PD_ENDDE": null,

"record": [

{

"MAINNO": "",

"VHMNO": "",

"GUBUN_NM": "",

"CHANGE_DE": "",

"FLAG": null,

"LEDGER_INDVDLZ_NO": "",

"DETAIL_SN": "",

"LEDGER_GROUP_NO": "",

"DTLS": "",

"SUBNO": null,

"RQRCNO": "",

"MAINCHK": "",

"CHANGE_JOB_SE_CODE": ""

}

],

"SPMNNO1": "",

"SPMNNO2": "",

"PROCESS_IMPRTY_RESN_CODE": "",

"FRST_REGIST_DE": "",

"OCTHT_ERSR_PRVNTC_NTICE_DE": null,

"ADRES1": "",

"ACQS_AMOUNT": "",

"MRTGCNT": "",

"TAXXMPT_TRGTER_SE_CODE_NM": null,

"PRYE": "",

"ERSR_REGIST_DE": "",

"MBER_SE_NO": "",

"CAAG_ENDDE": null,

"INSPT_VALID_PD_BGNDE": "",

"VHCTY_ASORT_CODE": "",

"PRVNTCCNT": "",

"VHCTY_ASORT_NM": "",

"CNTC_RESULT_CODE": "",

"TELNO": null,

"NMPL_STNDRD_NM": null,

"NMPL_STNDRD_CODE": null,

"CNM": "",

"CNTC_RESULT_DTLS": "",

"PROCESS_IMPRTY_RESN_DTLS": "",

"BSS_USE_PD": null,

"REGIST_REQST_SE_NM": "",

"STMDCNT": "",

"ADRES": "",

"FOM_NM": "",

"TRVL_DSTNC": "",

"ERSR_REGIST_SE_NM": "",

"MBER_NM": "",

"PARTN_RQRCNO": null,

"LEDGER_GROUP_NO": "",

"YBL_MD": "",

"EMD_NM": "",

"FRST_REGIST_RQRCNO": null,

"NMPL_CSDY_AT": "",

"REGIST_DETAIL_CODE": "",

"COLOR_CODE": null,

"LEDGER_INDVDLZ_NO": "",

"PRPOS_SE_NM": "",

"INSPT_VALID_PD_ENDDE": "",

"CNT_MATTER": "",

"ADRES_NM": "",

"VHCLECNT": "",

"VIN": "",

"REGIST_DETAIL_NM": "",

"ADRES_NM1": "",

"VHRNO": "",

"INDVDL_BSNM_AT": "",

"XPORT_FLFL_AT_STTEMNT_DE": null,

"NMPL_CSDY_REMNR_DE": null

}

]

}

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

서비스 수행 도중 오류가 발생한 경우 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"

}

}