1. OPEN-API 서비스 개요

• 대리운전사업자 소속의 대리기사 대리운전보험 가입여부를 사업자시스템과 보험망시스템간 실시간 연계를 제공하여 무보험운전과 무보험사고를 사전에 예방하는 보험-사회안전망 역할 제공합니다.

서비스 신청

• API 사용을 원하는 프로그램사의 경우 사업자 공동인증서(구 공인인증서)로 로그인하여 사업자정보 등록시 API신청 이후 보험개발원 승인 통지 이후 사용가능합니다.

2. 토큰 발행

• 보안 토큰은 대리운전보험 조회시스템의 업무API 대리기사정보 등록, 삭제, 개인정보 제공동의여부 조회, 보험가입여부 조회 등에 사용하는 필수 파라미터이며 사전에 반드시 토큰을 발급 받아 업무용 API를 사용해야 합니다. 그리고 보안토큰(Access Token)은 1회 사용 후 폐기되어 재사용이 불가능합니다.

요청 메시지 URL

요청 메시지 명세

요청 메시지 형태

• {
• "clientKey": "2ffd133a-d17a-431d-a6a5",
• "clientSecurity": "ASDF09FZddezplhbaKJNE#%",
• "appBizCode": "1112255555”",
• "bizSeqNo": "DB20201222002121BAC",
• "reqDate": "20201012140123",
• "reqBizCode": "D4"
• }

응답 메시지 명세

응답 메시지 형태

• {
• "accessToken": "DADFVBa-d17a-431d-DASFAS",
• "bizSeqNo": "DB20201222002121BAC”,
• "resDate": "20201012140123”
• }

보안토큰(Access Token) 활용

3. 대리운전기사 등록

• 대리운전업체에 소속된 대리기사의 개인정보(이름,주민번호 앞7자리, 핸드폰번호)를 대리운전보험조회시스템에 등록하고 대리기사가 개인정보제공 이용동의를 한 경우에만 보험망을 통해서 대리기사의 대리운전보험 가입 정보를 조회합니다. 대리기사정보가 등록되지 않으면 보험가입정보를 조회할 수 없습니다.

요청 메시지 URL

요청 메시지 명세

요청 메시지 형태

• {
• "clientKey": "2ffd133a-d17a-431d-a6a5",
• "bizCode": "1112255555",
• "bizName": "대리업체명",
• "accessToken": "DADFVBa-d17a-431d-DASFAS",
• "bizSeqNo": "DB20201222002121BAC",
• "reqCount": "10",
• "reqDate": "20201012140123",
• "reqList": [
• {
• "driverName": "홍길동“,
• "registerNo": "8805221“,
• "phone": "01022229999“ },
• { - } ,
• { - } ,
• { - } ,
• { - }
• ]
• }

응답 메시지 명세

응답 메시지 형태

• {
• "bizSeqNo": "DB20201222002121BAC”,
• "resCount": "10”,
• "resDate": "20201012140124“,
• "resList": [
• {
• "driverName": "홍길동“,
• "registerNo": "8805221“,
• "phone": "01022229999“,
• "resBizCode": "0000“,
• "resBizMessage": "정상처리“,
• },
• { - } ,
• { - } ,
• { - } ,
• { - }
• ]
• }

4. 대리운전기사 삭제

• 대리기사의 개인정보(이름,주민번호 앞7자리, 핸드폰번호)를 삭제할 수 있습니다.

요청 메시지 URL

요청 메시지 명세

요청 메시지 형태

• {
• "clientKey": "2ffd133a-d17a-431d-a6a5",
• "bizCode": "1112255555",
• "accessToken": "DADFVBa-d17a-431d-DASFAS",
• "bizSeqNo": "DB20201222002121BAC",
• "reqCount": "10",
• "reqDate": "20201012140123",
• "reqList": [
• {
• "driverName": "홍길동",
• "registerNo": "8805221",
• "phone": "01022229999" },
• { - } ,
• { - } ,
• { - } ,
• { - }
• ]
• }

응답 메시지 명세

응답 메시지 형태

• {
• "bizSeqNo": "DB20201222002121BAC",
• "resCount": "10",
• "resDate": "20201012140124",
• "resList": [
• {
• "driverName": "홍길동",
• "registerNo": "8805221",
• "phone": "01022229999",
• "resBizCode": "0000",
• "resBizMessage": "정상처리",
• },
• { - } ,
• { - } ,
• { - } ,
• { - }
• ]
• }

5. 개인정보 동의여부 조회

• 대리기사의 개인정보제공 동의 여부를 조회할 수 있습니다. 대리운전업체에 개인정보 제공동의에 동의한 기사에 한해서 보험 가입정보 조회가 가능합니다.

요청 메시지 URL

요청 메시지 명세

요청 메시지 형태

• {
• "clientKey" : "abcd-001-b0232e-zzfd-x4vd",
• "bizCode" : "1112255555",
• "accessToken" : "ASDF09FZddezplhbaKJNE#%",
• "bizSeqNo" : "DB20201222002121BAC",
• "reqDate" : "20201012140123",
• "agreeYn" : "Y",
• "fromDate" : "20200901",
• "toDate" : "20200931",
• "driverName" : "홍길동",
• "birthDay" : "8805231",
• "phone" : "01011112222",
• "orderType" : "1",
• "reqCount" : "10",
• "reqPage" : "1"
• }

응답 메시지 명세

응답 메시지 형태

• {
• "bizSeqNo": "DB20201222002121BAC",
• "totalCount": "251",
• "resCount": "10",
• "resDate": "20201012140124",
• "resList": [
• {
• "driverName": "홍길동",
• "registerNo": "8805221",
• "phone": "01022229999",
• "agreeYn": "Y",
• "agreeDate": "20200930131123",
• "resBizCode": "0000",
• "resBizMessage": "정상처리"
• },
• { - } ,
• { - } ,
• { - } ,
• { - }
• ]
• }

6. 대리운전보험 가입 조회

• 대리기사가 대리운전업체에 개인정보제공 동의를 한 경우 해당 기사의 개인형 대리운전보험 정보를 제공합니다.

요청 메시지 URL

요청 메시지 명세

요청 메시지 형태

• {
• "clientKey": "abcd-001-b0232e-zzfd-x4vd",
• "bizCode": "1112255555",
• "accessToken": "ASDF09FZddezplhbaKJNE#%",
• "bizSeqNo": "DB20201222002121BAC",
• "reqCount": "10",
• "reqDate": "20201012140123",
• "reqList": [
• {
• "driverName": "홍길동",
• "registerNo": "8805231",
• "phone": "01011112222"
• },
• { - } ,
• { - } ,
• { - }
• ]
• }

응답 메시지 명세

응답 메시지 형태

• {
• "bizSeqNo": "DB20201222002121BAC",
• "reqCount": "10",
• "resCount": "10",
• "resDate": "20201012140124",
• "resList": [
• {
• “driverName": "홍길동",
• "registerNo": "8805221",
• "phone": "01022229999",
• "insList": [
• {
• asEnrollYn : "Y",
• asInsuranceNo : "08-202022122202",
• asFromDate : "20200101220000",
• asToDate : "20201231235959",
• asPeople : "1",
• asPeoAmt : "5000",
• asGoodsAmt : "5000",
• asCarPercent : "10",
• asPerLow : "5",
• asPerHigh : "999",
• asDeadAmt : "10000",
• asInjAmt : "5000",
• asDisAmt : "10000",
• asMyCarAmt : "10000",
• asCompCd : "01",
• asCompName : "XX손보",
• enrollYn : "Y",
• insuranceNo : "08-202022122202",
• fromDate : "20200101220000",
• toDate : "20201231235959",
• people : "1",
• peoAmt : "5000",
• goodsAmt : "5000",
• carPercent : "10",
• perLow : "5",
• perHigh : "999",
• deadAmt : "10000",
• injAmt : "5000",
• disAmt : "10000"
• myCarAmt : "10000",
• compCd : "01",
• compName : "XX손보",
• }
• ]
• "resBizCode": "0000",
• "resBizMessage": "정상처리"
• },
• { - } ,
• { - } ,
• { - }
• ]
• }

• 응답메세지의 보험담보(insList)는 가입여부 ‘Y’ 경우만 데이터가 전송되며 미가입인 경우는 이름, 생년월일, 전화번호만 전송됩니다.