병원 정보 조회

캐릭터 인코딩은 UTF-8 을 기본으로 합니다.

secret key는 ‘서비스콘솔’ – ‘Sub Account’ 생성 시 키를 발급 받을 수 있습니다.

상세기능 번호	1	상세기능 유형	조회 (자료)
상세기능명(국문)	병원 정보 조회 서비스
상세기능 설명	건강보험심사평가원에서 관리하는 병원 정보를 조회하는 서비스입니다.
Call Back URL	https://i48ojxo10p.apigw.ntruss.com/public_hospital/v1/basic_info

병원 정보 조회 API

GET https://4vh6qtie3c.apigw.ntruss.com/public_hospital/v1/basic_info

Query Parameters

Name	Type	Description
pageNo*	string	페이지번호
numOfRows*	string	한 페이지 결과 수
zipCd*	string	분류코드(활용가이드 참조)
yadmNm*	string	병원명(UTF-8 인코딩 필요)
emdongNm*	string	읍면동명
sgguCd*	string	시군구코드
sidoCd*	string	시도코드
xPos*	string	x좌표(소수점 15)
dgsbjtCd*	string	진료과목코드(활용가이드 참조)
clCd*	string	종별코드(활용가이드 참조)
radius*	string	단위 : 미터(m)
yPos*	string	y좌표(소수점 15)

Headers

Name	Type	Description
Authorization*	string	사용자ID;secret key

200: OK 응답 반환 완료

Response Body

header

항목명(영문)	항목명(국문)	항목설명	타입
resultMsg	결과메세지	결과메세지	string
resultCode	결과코드	결과메세지	string

body

항목명(영문)	항목명(국문)	항목설명	타입
items	결과메세지	결과메세지	string
numOfRows	한 페이지 결과 수	한 페이지 결과 수	number
pageNo	페이지 수	페이지 수	number
totalCount	데이터 총 개수	데이터 총 개수	number

item

항목명(영문)	항목명(국문)	항목설명	타입
cmdcResdntCnt	한방레지던트 인원수	한방레지던트 인원수	string
cmdcSdrCnt	한방전문의 인원수	한방전문의 인원수	string
pnursCnt	조산사 인원수	조산사 인원수	string
XPos	x좌표	x좌표	string
YPos	y좌표	y좌표	string
distance	거리	거리	string
detyGdrCnt	치과일반의 인원수	치과일반의 인원수	string
detyIntnCnt	치과인턴 인원수	치과인턴 인원수	string
detyResdntCnt	치과레지던트 인원수	치과레지던트 인원수	string
detySdrCnt	치과전문의 인원수	치과전문의 인원수	string
cmdcGdrCnt	한방일반의 인원수	한방일반의 인원수	string
cmdcIntnCnt	한방인턴 인원수	한방인턴 인원수	string
mdeptResdntCnt	의과레지던트 인원수	의과레지던트 인원수	string
drTotCnt	의사총수	의사총수	string
mdeptGdrCnt	의과일반의 인원수	의과일반의 인원수	string
mdeptIntnCnt	의과인턴 인원수	의과인턴 인원수	string
telno	전화번호	전화번호	string
hospUrl	홈페이지	홈페이지	string
estbDd	개설일자	개설일자	string
sgguCdNm	시군구명	시군구명	number
emdongNm	읍면동명	읍면동명	string
postNo	우편번호	우편번호	string
addr	주소	주소	string
sidoCdNm	시도명	시도명	number
sgguCd	시군구코드	시군구코드	number
ykiho	암호화된 요양기호	암호화된 요양기호	string
yadmNm	병원명	병원명	string
clCd	종별코드	종별코드	string
clCdNm	종별코드명	종별코드명	string
sidoCd	시도코드	시도코드	number
mdeptSdrCnt	의과전문의 인원수	의과전문의 인원수	string

요청 및 응답 예시

URI

https://i48ojxo10p.apigw.ntruss.com/public_hospital/v1/basic_info?numOfRows=10

Response

{
  "response": {
      "header": {
           "resultCode": "00",
           "resultMsg": "NORMAL SERVICE."
      },
      "body": {
           "pageNo": 1,
           "totalCount": 76489,
           "items": {
              "item": [
                  {
                      "mdeptGdrCnt": 0,
                      "pnursCnt": 0,
                      "clCd": 1,
                      "mdeptSdrCnt": 235,
                      "ykiho": "JDQ4MTYyMiM1MSMkMSMkMCMkODkkMzgxMzUxIzExIyQxIyQzIyQ3OSQyNjE4MzIjNDEjJDEjJDgjJDgz",
                      "clCdNm": "상급종합",
                      "mdeptResdntCnt": 72,
                      "telno": "032-1544-9004",
                      "cmdcSdrCnt": 0,
                      "hospUrl": "http://www.cmcism.or.kr/",
                      "YPos": 37.4848309,
                      "detyIntnCnt": 0,
                      "cmdcIntnCnt": 0,
                      "sidoCd": 220000,
                      "estbDd": 19810806,
                      "emdongNm": "부평동",
                      "drTotCnt": 333,
                      "sgguCd": 220003,
                      "cmdcGdrCnt": 0,
                      "addr": "인천광역시 부평구 동수로 56 (부평동)",
                      "mdeptIntnCnt": 23,
                      "detyResdntCnt": 0,
                      "detySdrCnt": 2,
                      "yadmNm": "가톨릭대학교인천성모병원",
                      "postNo": 21431,
                      "detyGdrCnt": 1,
                      "cmdcResdntCnt": 0,
                      "XPos": 126.7248987,
                      "sidoCdNm": "인천",
                      "sgguCdNm": "인천부평구"
                  },
                  {
                      "mdeptGdrCnt": 3,
                      "pnursCnt": 0,
                      "clCd": 1,
                      "mdeptSdrCnt": 158
                      "ykiho": "JDQ4MTYyMiM1MSMkMSMkNCMkODkkMzgxMzUxIzExIyQxIyQzIyQ4OSQ0NjEwMDIjNDEjJDEjJDgjJDgz",
                      "clCdNm": "상급종합",
                      "mdeptResdntCnt": 34,
                      "telno": "033-610-3114",
                      "cmdcSdrCnt": 0,
                      "hospUrl": "http://www.gnah.co.kr",
                      "YPos": 37.8184325,
                      "detyIntnCnt": 0,
                      "cmdcIntnCnt": 0,
                      "sidoCd": 320000,
                      "estbDd": 19960730,
                      "drTotCnt": 197,
                      "sgguCd": 320100,
                      "cmdcGdrCnt": 0,
                      "addr": "강원도 강릉시 사천면 방동길 38 ()",
                      "mdeptIntnCnt": 0,
                      "detyResdntCnt": 0,
                      "detySdrCnt": 2,
                      "yadmNm": "강릉아산병원",
                      "postNo": 25440,
                      "detyGdrCnt": 0,
                      "cmdcResdntCnt": 0,
                      "XPos": 128.8578411,
                      "sidoCdNm": "강원",
                      "sgguCdNm": "강릉시"
                  }
              ]
          },
           "numOfRows": 2
      }
  }
}