대리기사 등록/ 삭제, 개인정보 동의여부 조회, 대리운전보험 가입 조회를 위한 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) : 자차 가입금액 (만원),
asOvdcPrttClCd (String, optional) : 자기차량손해 보장내용,
asRtvfPrttClCd (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) : 자차 가입금액 (만원),
ovdcPrttClCd (string, optional) : 자기차량손해 보장내용,
rtvfPrttClCd (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",
"asOvdcPrttClCd": "1",
"asRtvfPrttClCd": "1",
"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",
"ovdcPrttClCd": "1",
"rtvfPrttClCd": "1",
"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 | 현재 파일 |