건강보험_자격득실확인서 발급(간편인증)

민원여기요 > 개인민원 > 증명서 발급/확인 > 자격득실확인서

METHOD

POST

URI

/scrap/common/nhis/QualificationAcquisitionSimple

Content Type

application/json

Charset

UTF-8

Last Updated

2021-10-25

Request Fields

필드명(영문) 필드명(한글) 필수여부 암호화여부 타입 양식 최대길이 샘플데이터 설명

LOGINOPTION

간편인증로그인방법

STRING

0 : 카카오톡,
1 : 삼성패스,
2 : 페이코,
3 : 통신사,
4 : KB모바일인증서

간편인증 로그인시 필수필드.

JUMIN

주민등록번호

true

STRING

-

"-"를 제외한 13자리.
간편인증 로그인시 필수필드.

USERNAME

로그인용 성명

STRING

간편인증 로그인시 필수필드.

HPNUMBER

로그인용 휴대폰번호

STRING

"-"없이 휴대폰번호 입력.
간편인증 로그인시 필수필드.

TELECOMGUBUN

통신사구분

STRING

1 : SKT,
2 : KT,
3 : LG U+

간편인증(LOGINOPTION:3) 로그인시 필수필드

Response Fields

필드명(영문) 필드명(한글) 필수여부 암호화여부 타입 양식 최대길이 샘플데이터 설명

errCode

errCode

STRING

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

errMsg

errMsg

STRING

오류발생 시 오류메시지

result

result

STRING

SUCCESS/FAIL

data.RESULT

전체 성공/실패 여부

STRING

SUCCESS : 성공
FAIL :실패

data.ERRMSG

에러메세지

STRING

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

data.ERRDOC

에러 문서 메시지

STRING

-

data.ECODE

에러코드

STRING

data.ETRACK

에러추적번호

STRING

data.JOINLIST[].PRINTNUM

발급번호

STRING

-

data.JOINLIST[].JUMIN

주민등록번호(암호화)

true

STRING

-

-

data.JOINLIST[].CORPNAME

직장명

STRING

data.JOINLIST[].PERNAME

가입자 성명

STRING

data.JOINLIST[].JOINGUBUN

가입자구분

STRING

data.JOINLIST[].REGDATE

등록일

STRING

data.JOINLIST[].UNREGDATE

상실일

STRING

HTTP Request

POST /scrap/common/nhis/QualificationAcquisitionSimple
Host: https://datahub-dev.scraping.co.kr
Authorization: Token ******************************
Content-Length: 135
Content-Type: application/json;charset=UTF-8

{
  "LOGINOPTION" : "3",
  "JUMIN" : "8SxYL+DffMfIOWng==",
  "USERNAME" : "홍길동",
  "HPNUMBER" : "01012341234",
  "TELECOMGUBUN" : "1"
}

HTTP Response

HTTP/1.1 200 OK
Date:Mon, 25 Oct 2021 06:55:54 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Content-Length: 635

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "ERRMSG" : "",
    "ERRDOC" : "",
    "JOINLIST" : [ {
      "PERNAME" : "홍길동",
      "CORPNAME" : "기웅정보통신",
      "UNREGDATE" : "",
      "JOINGUBUN" : "직장가입자",
      "REGDATE" : "20160404",
      "PRINTNUM" : "20211019-H074-712312",
      "JUMIN" : "8SxYL+DffMfIOWng=="
    }, {
      "PERNAME" : "홍길동",
      "CORPNAME" : "기웅정보통신",
      "UNREGDATE" : "20160404",
      "JOINGUBUN" : "직장피부양자",
      "REGDATE" : "20071001",
      "PRINTNUM" : "20211019-H074-712312",
      "JUMIN" : "8SxYL+DffMfIOWng=="
    } ],
    "RESULT" : "SUCCESS"
  }
}

Curl Request

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

참고자료

2 Path Fields

Response

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

필드명(영문) 필드명(한글) 양식 설명

data.callbackId

콜백ID

data.callbackType

구분

'SMS', 'CAPTCHA', 'OTP', 'TWO', 'SINGLE', 'ANY'

data.callbackData

구분 값

Base64 Image.

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

data.timeout

타임아웃

해당시간까지 입력 가능

Request

다음의 API 로 요청

METHOD

POST

URI

/scrap/captcha
필드명(영문) 필드명(한글) 양식 설명

callbackId

콜백ID

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

callbackType

구분

'SMS', 'CAPTCHA', 'OTP', 'TWO', 'SINGLE', 'ANY'

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

callbackResponse

구분 값

callbackType(구분)이 'SMS', 'CAPTCHA', 'OTP', 'SINGLE’일 경우 인증문자 입력.

callbackResponse1

임시 비밀번호

callbackType(구분)이 'TWO’일 경우에만 해당. 요청 시 입력한 Email로 받은 임시 비밀번호.

callbackResponse2

변경할 비밀번호

callbackType(구분)이 'TWO’일 경우에만 해당.

retry

캡챠이미지 갱신여부

'Y':이미지 갱신

callbackType(구분)이 'CAPTCHA’일 경우에만 해당.