보건복지부_의료인 면허정보조회(간편인증)

보건복지부(lic.mohw.go.kr) Home > 나의민원 > 면허(자격)정보

METHOD

POST

URI

/scrap/common/mohw/MedicalLicenseInquirySimple

Content Type

application/json

Charset

UTF-8

Last Updated

2023-08-17

Request Fields

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

LOGINOPTION

간편인증로그인방법

true

STRING

0 : 카카오톡,
1 : 삼성패스,
2 : 페이코,
3 : 통신사,
5 : 네이버,
6 : 신한인증서

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

JUMIN

주민등록번호

true

true

STRING

"-"를 제외한 13자리

DSNM

성명

true

STRING

PHONENUM

휴대폰번호

true

STRING

"-"없이 입력.

TELECOMGUBUN

통신사구분

STRING

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

간편인증 로그인방법이 통신사일 경우 입력.

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.ECODE

에러코드

STRING

data.ETRACK

에러추적번호

STRING

data.ERRDOC

에러 문서 메시지

STRING

-

data.LICENSELIST[]

면허내역 반복부 시작

data.LICENSELIST[].INDEX

순번

STRING

data.LICENSELIST[].LICENSEKIND

면허종별

STRING

data.LICENSELIST[].LICENSENUM

면허번호

STRING

data.LICENSELIST[].LICENSEDATE

면허일자

STRING

yyyyMMdd

data.LICENSELIST[].LICENSENAME

면허이름

STRING

면허 소지자 이름

HTTP Request

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

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

HTTP Response

HTTP/1.1 200 OK
Date:Thu, 17 Aug 2023 07:56:02 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Content-Length: 364

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "ETRACK" : "",
    "ERRMSG" : "",
    "LICENSELIST" : [ {
      "LICENSENAME" : "홍길동",
      "INDEX" : "1",
      "LICENSEDATE" : "20180101",
      "LICENSEKIND" : "의사",
      "LICENSENUM" : "22185"
    } ],
    "ECODE" : "",
    "ERRDOC" : "",
    "RESULT" : "SUCCESS"
  }
}

Curl Request

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

참고자료

2 Path Fields

Response

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

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

data.callbackId

콜백ID

data.callbackType

구분

'SMS', 'CAPTCHA', 'OTP', 'TWO' , 'SINGLE' , 'ANY' , 'SIMPLE' , 'CERT-SIGN'

data.callbackData

구분 값

data.callbackType 필드가 'CAPTCHA’일 경우 Image 응답.
data.callbackType 필드가 'CERT-SIGN’일 경우 Object 응답

data.timeout

타임아웃

해당시간까지 입력 가능

Request

다음의 API 로 요청

METHOD

POST

URI

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

callbackId

콜백ID

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

callbackType

구분

'SMS', 'CAPTCHA', 'OTP', 'TWO' , 'SINGLE' , 'ANY' , 'SIMPLE' , 'CERT-SIGN'

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

callbackResponse

구분 값

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

callbackResponse1

임시 비밀번호

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

callbackResponse2

변경할 비밀번호

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

callbackResponseCert

변경할 비밀번호

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

retry

캡챠이미지 변경여부

'Y':캡챠이미지 변경.

callbackType(구분)이 'CAPTCHA’일 경우 캡챠이미지 변경요청할 때만 입력.