Scraping API Guide

보험개발원(KIDI)_과납 보험료 환급조회(사고조회)

과납 보험료 환급조회(사고조회): HOME > 과납보험료 환급신청 > 본인인증(모바일, 인증서) > 사고조회

METHOD

POST

URI

/scrap/common/kidi/OverpaymentPremiumRefunds

Request fields

필드명(영문) 필드명(한글) 암호화여부 양식 설명

필드명(영문)	필드명(한글)	암호화여부	양식	설명
`TELECOMGUBUN`	통신사구분		1: SKT, 2: KT, 3: LGU+
`PHONENUM`	휴대폰번호			"-"없이 입력.
`DSNM`	대상자명
`JUMIN`	주민등록번호(암호화)	TRUE	"-"를 제외한 13자리	토큰 발행 시 전달받은 암복호화 정보로 진행.

TELECOMGUBUN

통신사구분

1: SKT, 2: KT, 3: LGU+

PHONENUM

휴대폰번호

"-"없이 입력.

DSNM

대상자명

JUMIN

주민등록번호(암호화)

TRUE

"-"를 제외한 13자리

토큰 발행 시 전달받은 암복호화 정보로 진행.

Response fields

필드명(영문) 필드명(한글) 암호화여부 양식 설명

errCode

errCode

정상일 때는 '0000', 오류일 경우 오류코드 반환

errMsg

errMsg

오류발생 시 오류메시지

result

result

SUCCESS/FAIL

data.RESULT

전체 성공/실패 여부

SUCCESS : 성공 FAIL :실패

data.ERRMSG

오류 메시지

RESULT값이 FAILURE일 경우 스크래핑 서비스 오류 메세지 출력

data.ERRDOC

에러 문서 메시지

data.ECODE

에러코드

data.ETRACK

에러추적번호

data.CONTRACTLIST[].HOISAMYUNG

보험회사명

data.CONTRACTLIST[].INSURANCEITEM

보험종목

data.CONTRACTLIST[].CONTRACTNUMBER

계약번호

data.CONTRACTLIST[].CARNUMBER

차량(차대)번호

data.CONTRACTLIST[].ACCIDENTDATE

사고일시

data.CONTRACTLIST[].COLLATERALPERSON

담보(대인)

data.CONTRACTLIST[].COLLATERALTHING

담보(대물)

data.CONTRACTLIST[].COLLATERALLOSS

담보(차손)

data.CONTRACTLIST[].COLLATERALCAR

담보(차량)

data.CONTRACTLIST[].COLLATERALUNINSURED

담보(무보험)

data.CONTRACTLIST[].LEVEL

급수

data.CONTRACTLIST[].SCORE

점수

HTTP request

POST /scrap/common/kidi/OverpaymentPremiumRefunds HTTP/1.1
Host: datahub-dev.scraping.co.kr
Authorization: Token ******************************
Content-Type: application/json;charset=UTF-8
Content-Length: 114

{
  "TELECOMGUBUN" : "1",
  "PHONENUM" : "01012341234",
  "DSNM" : "홍길동",
  "JUMIN" : "8SxYL+DffMfIOWng=="
}

HTTP response

HTTP/1.1 200 OK
Date: Tue, 16 Mar 2021 02:43:13 GMT
Connection: keep-alive
Content-Type: application/json;charset=UTF-8
Content-Length: 635
Transfer-Encoding: chunked

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "ETRACK" : "6140",
    "CONTRACTLIST" : [ {
      "HOISAMYUNG" : "기웅손해보험",
      "COLLATERALTHING" : "0",
      "COLLATERALUNINSURED" : "0",
      "SCORE" : "0",
      "ACCIDENTDATE" : "202101010000",
      "COLLATERALPERSON" : "0",
      "COLLATERALCAR" : "0",
      "CONTRACTNUMBER" : "000000000000",
      "INSURANCEITEM" : "개인용자동차보험",
      "LEVEL" : "0",
      "CARNUMBER" : "123사5678",
      "COLLATERALLOSS" : "0"
    } ],
    "ERRMSG" : "",
    "ECODE" : "",
    "ERRDOC" : "",
    "RESULT" : "SUCCESS"
  }
}

Curl request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/common/kidi/OverpaymentPremiumRefunds' -i -X POST \
    -H 'Authorization: Token ******************************' \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "TELECOMGUBUN" : "1",
  "PHONENUM" : "01012341234",
  "DSNM" : "홍길동",
  "JUMIN" : "8SxYL+DffMfIOWng=="
}'

2 Path Fields

Response

errCode 값이 '0001' 인 경우 다음의 응답 데이터가 리턴됨.

필드명(영문)	필드명(한글)	양식	설명
data.callbackId	콜백ID
data.callbackType	구분	'SMS', 'CAPTCHA', 'OTP'
data.callbackData	구분 값		data.callbackType 필드가 'CAPTCHA’일 경우 Image 응답.
data.timeout	타임아웃		해당시간까지 입력 가능

필드명(영문)

필드명(한글)

양식

설명

data.callbackId

콜백ID

data.callbackType

구분

'SMS', 'CAPTCHA', 'OTP'

data.callbackData

구분 값

data.callbackType 필드가 'CAPTCHA’일 경우 Image 응답.

data.timeout

타임아웃

해당시간까지 입력 가능

Request

다음의 API 로 요청

METHOD

POST

URI

/scrap/captcha

필드명(영문)	필드명(한글)	양식	설명
callbackId	콜백ID		data.callbackId 필드로 응답받은 콜백ID 입력
callbackType	구분	'SMS', 'CAPTCHA', 'OTP'	data.callbackType 필드로 응답 받은 구분 입력
callbackResponse	구분 값		구분에 따른 인증문자 입력.

필드명(영문)

필드명(한글)

양식

설명

callbackId

콜백ID

data.callbackId 필드로 응답받은 콜백ID 입력

callbackType

구분

'SMS', 'CAPTCHA', 'OTP'

data.callbackType 필드로 응답 받은 구분 입력

callbackResponse

구분 값

구분에 따른 인증문자 입력.