대리기사 등록/ 삭제, 개인정보 동의여부 조회, 대리운전보험 가입 조회를 위한 Token Key를 생성합니다.
OK
RES /driver/{version}/getToken { accessToken (string, optional) : 대리운전보험 조회시스템을 사용하기 위한 1회용 토큰 값 (유효시간 6시간) , bizSeqNo (string, optional) : 사업자의 거래 추적번호 (사업자 고유생성값) , resDate (string, optional) : 응답일시 : YYYYMMDDHH24MISS }
{ "accessToken": "DADFVBa-d17a-431d-DASFAS", "bizSeqNo": "DB20201222002121BAC", "resDate": "20201012140123" }
Response Content Type
Parameter | Value | Data Type | Description |
---|---|---|---|
appBizCode | "1112255555" | String | API KEY를 발급받은 사업자번호(대리운전 시스템 업체 사업자번호) |
bizSeqNo | "DB20201222002121BAC" | String | 사업자의 거래 추적번호 : 사업자 생성한 고유값(unique) |
regBizCode | "D4" | String | 업무 코드 [ D1 : 대리기사등록 / D2 : 대리기사삭제 / D3 : 대리기사동의여부 / D4 : 대리운전보험 가입여부 조회 ] |
HTTP Status Code | Reason |
---|---|
200 | Ok |
201 | Created |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
400 | Bad Request |
408 | Request Timeout |
Response Status Code | Reason |
---|---|
"0000" | Ok |
"0400" | Bad Request |
"0401" | Unauthorized |
"0404" | Not Found |
curl -X POST –H "Content-Type: application/json" https://openapi.kidi.or.kr:2443/driver/v1/getToken -d "{\"clientKey\":
\"2ffd133a-d17a-431d-a6a5\", \"clientSecurity\": \"ASDF09FZddezplhbaKJNE#%\", \"appbizCode\": \"1112255555\",
\"bizSeqNo\": \"DB20201222002121BAC\", \"reqDate\": \"20201012140123\", \"reqBizCode\": \"D4\"}"
{ "Content-Type": "application/json" "Accept": "application/json" }
{ "accessToken": "DADFVBa-d17a-431d-DASFAS", "bizSeqNo": "DB20201222002121BAC", "resDate": "20201012140123" }
200
대리운전사업자에 소속 대리기사 정보를 등록합니다.
OK
RES /driver/{version}/insDriver { bizSeqNo (string, optional) : 거래고유번호, resCount (int, optional) : 응답건수 (MAX 1,000), resDate (string, optional) : 응답일시 (YYYYMMDDHH24MISS), resList: [ { driverName (string, optional) : 대리기사 성명, registerNo (string, optional) : 대리기사 주민번호, phone (string, optional) : 핸드폰번호, resBizCode (string, optional) : 오류코드, resBizMessage (string, optional) : 오류메시지 }, { - } ] }
{ "bizSeqNo": "DB20201222002121BAC", "resCount": 10, "resDate": "20201012140124", "resList": [ { "driverName": "홍길동", "registerNo": "8805221", "phone": "01022229999", "resBizCode": "0000", "resBizMessage": "정상처리", }, { - } ] }
Response Content Type
Parameter | Value | Data Type | Description |
---|---|---|---|
bizCode | "1112255555" | String | 대리운전업체 사업자 번호 |
bizName | "대리업체1" | String | 대리운전업체 사업자명 |
bizSeqNo | "DB20201222002121BAC" | String | 사업자의 거래 추적번호 : 사업자 생성한 고유값(unique) |
reqCount | 2 | Int | 요청건수 : MAX 1,000 |
reqList | [{…},{…}] | List | 대리기사 등록 리스트 |
Parameter | Value | Data Type | Description |
---|---|---|---|
driverName | "홍길동" | String | 대리기사 성명 |
registerNo | "8805221" | String | 대리기사 주민번호 |
phone | "01022229999" | String | 핸드폰번호 |
HTTP Status Code | Reason |
---|---|
200 | Ok |
201 | Created |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
400 | Bad Request |
408 | Request Timeout |
Response Status Code | Reason |
---|---|
"0000" | Ok |
"0400" | Bad Request |
"0401" | Unauthorized |
"0404" | Not Found |
curl -X POST –H "Content-Type: application/json" https://openapi.kidi.or.kr:2443/driver/v1/insDriver -d "{\"clientKey\":
\"2ffd133a-d17a-431d-a6a5\", \"bizCode\": \"1112255555\", \"bizName\": \"대리업체1\", \"accessToken\": \"DADFVBa-d17a-431d-DASFAS\",
\"bizSeqNo\": \"DB20201222002121BAC\", \"reqCount\": 2, \"reqDate\": \"20201012140123\", \"reqList\":
[ { \"driverName\": \"홍길동\", \"registerNo\": \"8805221\", \"phone\": \"01022229999\" }, { \"driverName\":
\"고길동\", \"registerNo\": \"7811251\", \"phone\": \"01022229999\" } ] }"
{ "Content-Type": "application/json" "Accept": "application/json" }
{ "bizSeqNo": "DB20201222002121BAC", "resCount": 10, "resDate": "20201012140124", "resList": [ { "driverName": "홍길동", "registerNo": "8805221", "phone": "01022229999", "resBizCode": "0000", "resBizMessage": "정상처리", }, { "driverName": "고길동", "registerNo": "7811251", "phone": "01022229999", "resBizCode": "0000", "resBizMessage": "정상처리", }, ] }
200
대리운전 보험조회시스템에 등록된 대리기사의 개인정보를 삭제합니다.
OK
RES /driver/{version}/delDriver { bizSeqNo (string, optional) : 거래고유번호, resCount (int, optional) : 응답건수 (MAX 1,000), resDate (string, optional) : 응답일시 (YYYYMMDDHH24MISS), resList: [ { driverName (string, optional) : 대리기사 성명, registerNo (string, optional) : 대리기사 주민번호, phone (string, optional) : 핸드폰번호, resBizCode (string, optional) : 오류코드, resBizMessage (string, optional) : 오류메시지 }, { - } ] }
{ "bizSeqNo": "DB20201222002121BAC", "resCount": 10, "resDate": "20201012140124", "resList": [ { "driverName": "홍길동", "registerNo": "8805221", "phone": "01022229999", "resBizCode": "0000", "resBizMessage": "정상처리", }, { - } ] }
Response Content Type
Parameter | Value | Data Type | Description |
---|---|---|---|
bizCode | "1112255555" | String | 대리운전업체 사업자 번호 |
bizSeqNo | "DB20201222002121BAC" | String | 사업자의 거래 추적번호 : 사업자 생성한 고유값(unique) |
reqCount | 2 | Int | 요청건수 : Max 1,000 |
reqList | [{…},{…}] | List | 대리기사 삭제 리스트 |
Parameter | Value | Data Type | Description |
---|---|---|---|
driverName | "홍길동" | String | 보험개발원에서 발급한 Client Key |
registerNo | "8805221" | String | 대리기사 주민번호 |
phone | "01022229999" | String | 핸드폰번호 |
HTTP Status Code | Reason |
---|---|
200 | Ok |
201 | Created |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
400 | Bad Request |
408 | Request Timeout |
Response Status Code | Reason |
---|---|
"0000" | Ok |
"0400" | Bad Request |
"0401" | Unauthorized |
"0404" | Not Found |
curl -X POST –H "Content-Type: application/json" https://openapi.kidi.or.kr:2443/driver/v1/delDriver -d "{\"clientKey\":
\"2ffd133a-d17a-431d-a6a5\", \"bizCode\": \"1112255555\", \"accessToken\": \"DADFVBa-d17a-431d-DASFAS\",
\"bizSeqNo\": \"DB20201222002121BAC\", \"reqCount\": 2, \"reqDate\": \"20201012140123\", \"reqList\":
[ { \"driverName\": \"홍길동\", \"registerNo\": \"8805221\", \"phone\": \"01022229999\" }, { \"driverName\":
\"고길동\", \"registerNo\": \"7811251\", \"phone\": \"01022229999\" } ] }"
{ "Content-Type": "application/json" "Accept": "application/json" }
{ "bizSeqNo": "DB20201222002121BAC", "resCount": 10, "resDate": "20201012140124", "resList": [ { "driverName": "홍길동", "registerNo": "8805221", "phone": "01022229999", "resBizCode": "0000", "resBizMessage": "정상처리", }, { "driverName": "고길동", "registerNo": "7811251", "phone": "01022229999", "resBizCode": "0000", "resBizMessage": "정상처리", }, ] }
200
대리운전 보험조회시스템에 등록된 대리기사의 개인정보제공 동의 정보를 조회합니다.
OK
RES /driver/{version}/getDriver { bizSeqNo (string, optional) : 거래고유번호, totalCount (int, optional) : 전체 검색건수, resCount (int, optional) : 응답건수 (MAX 1,000), resDate (string, optional) : 응답일시 (YYYYMMDDHH24MISS), resList: [ { driverName (string, optional) : 대리기사 성명, registerNo (string, optional) : 대리기사 주민번호, phone (string, optional) : 핸드폰번호, agreeYn (string, optional) : 이용동의 여부, agreeDate (string, optional) : 이용동의 일시, resBizCode (string, optional) : 오류코드, resBizMessage (string, optional) : 오류메시지 }, { - } ] }
{ "bizSeqNo": "DB20201222002121BAC", "totalCount": 251, "resCount": 1, "resDate": "20201012140124", "resList": [ { "driverName": "홍길동", "registerNo": "8805221", "phone": "01022229999", "agreeYn": "Y", "agreeDate": "20200930131123", "resBizCode": "0000", "resBizMessage": "정상처리" }, { - } ] }
Response Content Type
Parameter | Value | Data Type | Description |
---|---|---|---|
bizCode | "1112255555" | String | 대리운전업체 사업자 번호 |
bizSeqNo | "DB20201222002121BAC" | String | 사업자의 거래 추적번호 : 사업자 생성한 고유값(unique) |
agreeYn | "Y" | String | Y : 동의 / C : 철회 / A : 전체 / M : 미동의 |
fromDate | "20200901" | String | 조회기간 : 시작일자 |
toDate | "20200931" | String | 조회기간 : 종료일자 |
driverName | "홍길동" | String | 대리기사 성명 |
birthDay | "8805231" | String | 대리기사 생년월일 |
phone | "01011112222" | String | 핸드폰번호 |
orderType | "1" | String | 정렬 [ 1 : 등록일자(내림차순) / 2 : 이름+생년월일(성별)(오름차순)] |
reqCount | 2 | Int | 요청건수 : Max 1,000 또는 공란 |
reqPage | "1" | String | 요청페이지 |
HTTP Status Code | Reason |
---|---|
200 | Ok |
201 | Created |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
400 | Bad Request |
408 | Request Timeout |
Response Status Code | Reason |
---|---|
"0000" | Ok |
"0400" | Bad Request |
"0401" | Unauthorized |
"0404" | Not Found |
curl -X POST –H "Content-Type: application/json" https://openapi.kidi.or.kr:2443/driver/v1/getDriver -d "{ \"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" }"
{ "Content-Type": "application/json" "Accept": "application/json" }
{ "bizSeqNo": "DB20201222002121BAC", "totalCount": 1, "resCount": 1, "resDate": "20201012140124", "resList": [ { "driverName": "홍길동", "registerNo": "8805231", "phone": "01011112222", "agreeYn": "Y", "agreeDate": "20200930131123", "resBizCode": "0000", "resBizMessage": "정상처리" } ] }
200
대리운전 보험조회시스템에 등록된 대리기사의 동의를 받은 대리기사의 보험가입 여부를 조회합니다.
OK
RES /driver/{version}/findInsurance { bizSeqNo (string, optional) : 거래고유번호, reqCount (string, optional) : 요청건수 (MAX 1,000), resCount (string, optional) : 응답건수 (MAX 1,000), resDate (string, optional) : 응답일시 (YYYYMMDDHH24MISS), resList: [ { driverName (string, optional) : 대리기사 성명, registerNo (string, optional) : 대리기사 주민번호, phone (string, optional) : 핸드폰번호, insList: [ { asEnrollYn (string, optional) : 가입 여부, asInsuranceNo (string, optional) : 보험증권번호, asFromDate (string, optional) : 보험시작일시, asToDate (string, optional) : 보험종료일시, asPeople (string, optional) : 대인 가입 '1', 미가임 '2’, asPeoAmt (string, optional) : 대인금액 (만원), asGoodsAmt (string, optional) : 대물금액 (만원), asCarPercent (string, optional) : 자차 정률제 (%), asPerLow (string, optional) : 자차 자기부담금 하한 (만원), asPerHigh (string, optional) : 자차 자기부담금 상한 (만원), asDeadAmt (string, optional) : 자손/자상 사망 (만원), asInjAmt (string, optional) : 자손/자상 부상 (만원), asDisAmt (string, optional) : 자손/자상 후유장애 (만원), asMyCarAmt (string, optional) : 자차 가입금액 (만원), asCompCd (string, optional) : 보험사코드, asCompName (string, optional) : 보험사명, enrollYn (string, optional) : 가입 여부, insuranceNo (string, optional) : 보험증권번호, fromDate (string, optional) : 보험시작일시, toDate (string, optional) : 보험종료일시, people (string, optional) : 대인 가입 '1', 미가임 '2’, peoAmt (string, optional) : 대인금액 (만원), goodsAmt (string, optional) : 대물금액 (만원), carPercent (string, optional) : 자차 정률제 (%), perLow (string, optional) : 자차 자기부담금 하한 (만원), PerHigh (string, optional) : 자차 자기부담금 상한 (만원), deadAmt (string, optional) : 자손/자상 사망 (만원), injAmt (string, optional) : 자손/자상 부상 (만원), disAmt (string, optional) : 자손/자상 후유장애 (만원), myCarAmt (string, optional) : 자차 가입금액 (만원), compCd (string, optional) : 보험사코드, compName (string, optional) : 보험사명, } ], resBizCode (string, optional) : 오류코드, resBizMessage (string, optional) : 오류메시지 }, { - } ] }
{ "bizSeqNo": "DB20201222002121BAC", "reqCount": 2, "resCount": 1, "resDate": "20201012140124", "resList": [ { "driverName": "홍길동", "registerNo": "8805231", "phone": "01011112222", "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": "정상처리" }, { "driverName": "고길동", "registerNo": "7804121", "phone": "01011115555", "insList": [ { "asEnrollYn" : "Y" , "asInsuranceNo" : "08-201922112001" , "asFromDate" : "20190101220000", "asToDate" : "20191231235959", "asPeople" : "1", "asPeoAmt" : "5000", "asGoodsAmt" : "5000", "asCarPercent" : "10", "asPerLow" : "5", "asPerHigh" : "999", "asDeadAmt" : "10000", "asInjAmt" : "5000", "asDisAmt" : "10000", "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" } ], "resBizCode": "0000", "resBizMessage": "정상처리" } ] }
Response Content Type
Parameter | Value | Data Type | Description |
---|---|---|---|
bizCode | "1112255555" | String | 대리운전업체 사업자 번호 |
bizSeqNo | "DB20201222002121BAC" | String | 사업자의 거래 추적번호 : 사업자 생성한 고유값(unique) |
reqCount | 10 | Int | 요청건수 : Max 1,000 |
reqList | [{…},{…}] | List | 대리기사 리스트 |
Parameter | Value | Data Type | Description |
---|---|---|---|
driverName | "홍길동" | String | 보험개발원에서 발급한 Client Key |
registerNo | "8805221" | String | 대리기사 주민번호 |
phone | "01022229999" | String | 핸드폰번호 |
HTTP Status Code | Reason |
---|---|
200 | Ok |
201 | Created |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
400 | Bad Request |
408 | Request Timeout |
Response Status Code | Reason |
---|---|
"0000" | Ok |
"0400" | Bad Request |
"0401" | Unauthorized |
"0404" | Not Found |
curl -X POST –H "Content-Type: application/json" https://openapi.kidi.or.kr:2443/driver/v1/findInsurance -d "{ "clientKey":"abcd-001-b0232e-zzfd-x4vd", "bizCode": "1112255555", "accessToken": "ASDF09FZddezplhbaKJNE#%","bizSeqNo": "DB20201222002121BAC", "reqCount": 10, "reqDate": "20201012140123", "reqList": [ { "driverName":"홍길동", "registerNo": "8805231", "phone": "01011112222" }, { "driverName": "고길동", "registerNo":"7804121", "phone": "01011115555" } ] }"
{ "Content-Type": "application/json" "Accept": "application/json" }
{ "bizSeqNo": "DB20201222002121BAC", "reqCount": 2, "resCount": 1, "resDate": "20201012140124", "resList": [ { "driverName": "홍길동", "registerNo": "8805231", "phone": "01011112222", "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", "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" } ], "resBizCode": "0000", "resBizMessage": "정상처리" }, { "driverName": "고길동", "registerNo": "7804121", "phone": "01011115555", "insList": [ { "asEnrollYn" : "Y" , "asInsuranceNo" : "08-201922112001" , "asFromDate" : "20190101220000", "asToDate" : "20191231235959", "asPeople" : "1", "asPeoAmt" : "5000", "asGoodsAmt" : "5000", "asCarPercent" : "10", "asPerLow" : "5", "asPerHigh" : "999", "asDeadAmt" : "10000", "asInjAmt" : "5000", "asDisAmt" : "10000", "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" } ], "resBizCode": "0000", "resBizMessage": "정상처리" } ] }
200
보험개발원 대리운전보험 조회시스템 API 개발 지원 도구인 API 로컬테스트 페이지를 배포 하오니,
대리운전보험 조회시스템 APP 서비스를 개발하시는 이용 기관의 많은 이용 부탁드립니다.
No. | 파일명 | 설명 |
---|---|---|
1 | local-test-driver01.0.jar | 로컬테스트페이지 프로그램 파일 |
2 | run-local-test-driver.bat | 로컬테스트페이지 실행 파일 |
3 | 실행방법 및 Java 설정 방법.pdf | 실행방법 및 Java 설정 방법 안내 파일 |
4 | Readme.txt | 현재 파일 |