Hans API

Appearance

국립중앙의료원 원본 ​

국립중앙의료원(NMC) 병원 정보 API입니다. 병원 목록 조회와 기관 ID(hpid) 기반 상세 조회를 제공합니다.

접근 권한 안내

이 데이터는 정부데이터 원본(공공데이터포털)을 캐싱한 자료입니다. 현재는 공개되어 있으나, 추후 허가받은 사용자만 접근할 수 있도록 제한될 예정입니다.

특징 ​

  • 공공데이터포털의 데이터를 빠르게 접근할 수 있습니다.
  • 필터 조건을 세분화하고 검색 성능을 개선했습니다.

데이터 출처 ​

  • 국립중앙의료원(NMC)에 등록된 정보입니다. — https://www.nmc.or.kr
  • 대한민국 공공데이터포털에서 제공한 원본 데이터를 캐싱하여 제공합니다.
  • 원본 데이터포털과 하루 한 번 재동기화됩니다.

데이터 정확성

데이터가 잘못된 경우, 원본 제공처(국립중앙의료원 또는 공공데이터포털)의 원본 데이터 오류일 수 있습니다.

TIP

  • 값이 없는(null) 필드는 응답에서 생략됩니다.

병원 목록 조회​

GET
/data-go-kr/nmc/hospitals

로컬 DB 에 미러링한 NMC 병원 목록. 응답 구조는 원본 API 와 동일하다.

Request

🔒 Bearer 인증 필요 · 인증 방법
GET/data-go-kr/nmc/hospitals

Query Parameters

NameTypeRequiredConstraintsDescription
pagenumberoptionaldefault 1페이지 번호
sizenumberoptionalmin 1 · max 100 · default 20페이지 크기

Response

200

NmcHospitalFullDownResponse

FieldTypeRequiredConstraintsDescription
responseNmcHospitalFullDownResultoptional

NmcHospitalFullDownResult

FieldTypeRequiredConstraintsDescription
headerNmcResultHeaderoptional
↳resultCodestringoptional결과코드 (정상: 00)
↳resultMsgstringoptional결과메시지
bodyNmcHospitalFullDownBodyoptional
↳numOfRowsintegeroptional한 페이지 결과 수
↳pageNointegeroptional현재 페이지 번호
↳totalCountintegeroptional전체 결과 수
↳itemsNmcHospitalFullDownItemsoptional
↳itemNmcHospitalFullDownItem[]optional
↳rnumintegeroptional일련번호
↳hpidstringoptional기관ID
↳dutyNamestringoptional기관명
↳dutyAddrstringoptional주소
↳dutyDivNmcDutyDivoptional
↳dutyDivNamstringoptional병원분류명
↳dutyEmclsstringoptional응급의료기관코드
↳dutyEmclsNamestringoptional응급의료기관코드명
↳dutyErynstringoptional응급실운영여부 (1:운영, 2:미운영)
↳dutyEtcstringoptional비고
↳dutyInfstringoptional기관설명상세
↳dutyMapimgstringoptional간이약도
↳dutyTel1stringoptional대표전화1
↳dutyTel3stringoptional응급실전화
↳postCdn1stringoptional우편번호1
↳postCdn2stringoptional우편번호2
↳wgs84Lonstringoptional병원경도
↳wgs84Latstringoptional병원위도
↳dutyTime1sstringoptional진료시간(월요일) 시작
↳dutyTime2sstringoptional진료시간(화요일) 시작
↳dutyTime3sstringoptional진료시간(수요일) 시작
↳dutyTime4sstringoptional진료시간(목요일) 시작
↳dutyTime5sstringoptional진료시간(금요일) 시작
↳dutyTime6sstringoptional진료시간(토요일) 시작
↳dutyTime7sstringoptional진료시간(일요일) 시작
↳dutyTime8sstringoptional진료시간(공휴일) 시작
↳dutyTime1cstringoptional진료시간(월요일) 종료
↳dutyTime2cstringoptional진료시간(화요일) 종료
↳dutyTime3cstringoptional진료시간(수요일) 종료
↳dutyTime4cstringoptional진료시간(목요일) 종료
↳dutyTime5cstringoptional진료시간(금요일) 종료
↳dutyTime6cstringoptional진료시간(토요일) 종료
↳dutyTime7cstringoptional진료시간(일요일) 종료
↳dutyTime8cstringoptional진료시간(공휴일) 종료
↳sidoNmstringoptional시도명 (예: 서울특별시). **원본 API 에는 없는 파생 필드다.** 주소(dutyAddr)의 첫 토큰에서 추출하며, 축약 표기(서울)는 정식 명칭(서울특별시)으로 정규화한다.
↳sgguNmstringoptional시군구명 (예: 강남구). **원본 API 에는 없는 파생 필드다.** 주소(dutyAddr)의 둘째 토큰에서 추출한다. 시 아래 구가 있으면 두 토큰을 합친다(예: 수원시 팔달구). 세종특별자치시처럼 시군구가 없는 지역은 값이 없다.
{
  "response": {
    "header": {
      "resultCode": "string",
      "resultMsg": "string"
    },
    "body": {
      "numOfRows": 0,
      "pageNo": 0,
      "totalCount": 0,
      "items": {
        "item": [
          {
            "rnum": 0,
            "hpid": "string",
            "dutyName": "string",
            "dutyAddr": "string",
            "dutyDiv": "string",
            "dutyDivNam": "string",
            "dutyEmcls": "string",
            "dutyEmclsName": "string",
            "dutyEryn": "string",
            "dutyEtc": "string",
            "dutyInf": "string",
            "dutyMapimg": "string",
            "dutyTel1": "string",
            "dutyTel3": "string",
            "postCdn1": "string",
            "postCdn2": "string",
            "wgs84Lon": "string",
            "wgs84Lat": "string",
            "dutyTime1s": "string",
            "dutyTime2s": "string",
            "dutyTime3s": "string",
            "dutyTime4s": "string",
            "dutyTime5s": "string",
            "dutyTime6s": "string",
            "dutyTime7s": "string",
            "dutyTime8s": "string",
            "dutyTime1c": "string",
            "dutyTime2c": "string",
            "dutyTime3c": "string",
            "dutyTime4c": "string",
            "dutyTime5c": "string",
            "dutyTime6c": "string",
            "dutyTime7c": "string",
            "dutyTime8c": "string",
            "sidoNm": "서울특별시",
            "sgguNm": "강남구"
          }
        ]
      }
    }
  }
}

Playground​

Server
Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI

병원 상세 조회​

GET
/data-go-kr/nmc/hospitals/{hpid}

기관ID 로 1건 조회. 없으면 items 가 빈 배열이고 totalCount 가 0 이다(원본 API 와 동일).

Request

🔒 Bearer 인증 필요 · 인증 방법
GET/data-go-kr/nmc/hospitals/{hpid}

Path Parameters

NameTypeRequiredConstraintsDescription
hpidstringrequired기관ID

Response

200

NmcHospitalFullDownResponse

FieldTypeRequiredConstraintsDescription
responseNmcHospitalFullDownResultoptional

NmcHospitalFullDownResult

FieldTypeRequiredConstraintsDescription
headerNmcResultHeaderoptional
↳resultCodestringoptional결과코드 (정상: 00)
↳resultMsgstringoptional결과메시지
bodyNmcHospitalFullDownBodyoptional
↳numOfRowsintegeroptional한 페이지 결과 수
↳pageNointegeroptional현재 페이지 번호
↳totalCountintegeroptional전체 결과 수
↳itemsNmcHospitalFullDownItemsoptional
↳itemNmcHospitalFullDownItem[]optional
↳rnumintegeroptional일련번호
↳hpidstringoptional기관ID
↳dutyNamestringoptional기관명
↳dutyAddrstringoptional주소
↳dutyDivNmcDutyDivoptional
↳dutyDivNamstringoptional병원분류명
↳dutyEmclsstringoptional응급의료기관코드
↳dutyEmclsNamestringoptional응급의료기관코드명
↳dutyErynstringoptional응급실운영여부 (1:운영, 2:미운영)
↳dutyEtcstringoptional비고
↳dutyInfstringoptional기관설명상세
↳dutyMapimgstringoptional간이약도
↳dutyTel1stringoptional대표전화1
↳dutyTel3stringoptional응급실전화
↳postCdn1stringoptional우편번호1
↳postCdn2stringoptional우편번호2
↳wgs84Lonstringoptional병원경도
↳wgs84Latstringoptional병원위도
↳dutyTime1sstringoptional진료시간(월요일) 시작
↳dutyTime2sstringoptional진료시간(화요일) 시작
↳dutyTime3sstringoptional진료시간(수요일) 시작
↳dutyTime4sstringoptional진료시간(목요일) 시작
↳dutyTime5sstringoptional진료시간(금요일) 시작
↳dutyTime6sstringoptional진료시간(토요일) 시작
↳dutyTime7sstringoptional진료시간(일요일) 시작
↳dutyTime8sstringoptional진료시간(공휴일) 시작
↳dutyTime1cstringoptional진료시간(월요일) 종료
↳dutyTime2cstringoptional진료시간(화요일) 종료
↳dutyTime3cstringoptional진료시간(수요일) 종료
↳dutyTime4cstringoptional진료시간(목요일) 종료
↳dutyTime5cstringoptional진료시간(금요일) 종료
↳dutyTime6cstringoptional진료시간(토요일) 종료
↳dutyTime7cstringoptional진료시간(일요일) 종료
↳dutyTime8cstringoptional진료시간(공휴일) 종료
↳sidoNmstringoptional시도명 (예: 서울특별시). **원본 API 에는 없는 파생 필드다.** 주소(dutyAddr)의 첫 토큰에서 추출하며, 축약 표기(서울)는 정식 명칭(서울특별시)으로 정규화한다.
↳sgguNmstringoptional시군구명 (예: 강남구). **원본 API 에는 없는 파생 필드다.** 주소(dutyAddr)의 둘째 토큰에서 추출한다. 시 아래 구가 있으면 두 토큰을 합친다(예: 수원시 팔달구). 세종특별자치시처럼 시군구가 없는 지역은 값이 없다.
{
  "response": {
    "header": {
      "resultCode": "string",
      "resultMsg": "string"
    },
    "body": {
      "numOfRows": 0,
      "pageNo": 0,
      "totalCount": 0,
      "items": {
        "item": [
          {
            "rnum": 0,
            "hpid": "string",
            "dutyName": "string",
            "dutyAddr": "string",
            "dutyDiv": "string",
            "dutyDivNam": "string",
            "dutyEmcls": "string",
            "dutyEmclsName": "string",
            "dutyEryn": "string",
            "dutyEtc": "string",
            "dutyInf": "string",
            "dutyMapimg": "string",
            "dutyTel1": "string",
            "dutyTel3": "string",
            "postCdn1": "string",
            "postCdn2": "string",
            "wgs84Lon": "string",
            "wgs84Lat": "string",
            "dutyTime1s": "string",
            "dutyTime2s": "string",
            "dutyTime3s": "string",
            "dutyTime4s": "string",
            "dutyTime5s": "string",
            "dutyTime6s": "string",
            "dutyTime7s": "string",
            "dutyTime8s": "string",
            "dutyTime1c": "string",
            "dutyTime2c": "string",
            "dutyTime3c": "string",
            "dutyTime4c": "string",
            "dutyTime5c": "string",
            "dutyTime6c": "string",
            "dutyTime7c": "string",
            "dutyTime8c": "string",
            "sidoNm": "서울특별시",
            "sgguNm": "강남구"
          }
        ]
      }
    }
  }
}

Playground​

Server
Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI

코드마스터 목록 조회​

GET
/data-go-kr/nmc/codes

로컬 DB 에 미러링한 NMC 코드마스터. 응답 구조는 원본 API 와 동일하다.

Request

🔒 Bearer 인증 필요 · 인증 방법
GET/data-go-kr/nmc/codes

Query Parameters

NameTypeRequiredConstraintsDescription
pagenumberoptionaldefault 1페이지 번호
sizenumberoptionalmin 1 · max 100 · default 20페이지 크기
cmMidstringoptional대분류코드(cmMid). 예: H010=설립구분. 생략하면 전체 코드를 반환한다.

Response

200

NmcCodeInfoResponse

FieldTypeRequiredConstraintsDescription
responseNmcCodeInfoResultoptional

NmcCodeInfoResult

FieldTypeRequiredConstraintsDescription
headerNmcResultHeaderoptional
↳resultCodestringoptional결과코드 (정상: 00)
↳resultMsgstringoptional결과메시지
bodyNmcCodeInfoBodyoptional
↳numOfRowsintegeroptional한 페이지 결과 수
↳pageNointegeroptional현재 페이지 번호
↳totalCountintegeroptional전체 결과 수
↳itemsNmcCodeInfoItemsoptional
↳itemNmcCodeInfoItem[]optional
↳cmMidstringoptional대분류코드 (예: H010)
↳cmMnmstringoptional코드명 (예: 설립구분)
↳cmSidstringoptional소분류코드 (예: F001)
↳cmSnmstringoptional코드약어 (예: 국립)
{
  "response": {
    "header": {
      "resultCode": "string",
      "resultMsg": "string"
    },
    "body": {
      "numOfRows": 0,
      "pageNo": 0,
      "totalCount": 0,
      "items": {
        "item": [
          {
            "cmMid": "string",
            "cmMnm": "string",
            "cmSid": "string",
            "cmSnm": "string"
          }
        ]
      }
    }
  }
}

Playground​

Server
Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI

지역 목록 조회​

GET
/data-go-kr/nmc/regions

병원 데이터에서 집계한 시도·시군구 목록. 병원이 1건 이상 있는 지역만 나온다.

Request

🔒 Bearer 인증 필요 · 인증 방법
GET/data-go-kr/nmc/regions

Query Parameters

NameTypeRequiredConstraintsDescription
pagenumberoptionaldefault 1페이지 번호
sizenumberoptionalmin 1 · max 100 · default 20페이지 크기

Response

200

NmcRegionResponse

FieldTypeRequiredConstraintsDescription
responseNmcRegionResultrequired

NmcRegionResult

FieldTypeRequiredConstraintsDescription
headerKrDataHeaderrequired
↳resultCodestringrequired결과 코드. 정상은 00
↳resultMsgstringrequired결과 메시지
bodyNmcRegionBodyrequired
↳itemsNmcRegionItemsrequired
↳itemNmcRegionItem[]required
↳sidoNmstringrequired시도명
↳sgguNmstringoptional시군구명. 세종특별자치시처럼 시군구가 없는 지역은 값이 없다.
↳hospitalCountnumberrequired이 지역의 병원 수
↳numOfRowsnumberrequired한 페이지 결과 수
↳pageNonumberrequired페이지 번호
↳totalCountnumberrequired전체 결과 수
{
  "response": {
    "header": {
      "resultCode": "00",
      "resultMsg": "NORMAL SERVICE."
    },
    "body": {
      "items": {
        "item": [
          {
            "sidoNm": "서울특별시",
            "sgguNm": "강남구",
            "hospitalCount": 3045
          }
        ]
      },
      "numOfRows": 100,
      "pageNo": 1,
      "totalCount": 263
    }
  }
}

Playground​

Server
Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI

병원 진료과목 조회​

GET
/data-go-kr/nmc/hospitals/{hpid}/subjects

해당 병원이 진료하는 과목 목록. 코드마스터 D000 기준이다.

Request

🔒 Bearer 인증 필요 · 인증 방법
GET/data-go-kr/nmc/hospitals/{hpid}/subjects

Path Parameters

NameTypeRequiredConstraintsDescription
hpidstringrequired기관ID

Response

200

NmcSubjectResponse

FieldTypeRequiredConstraintsDescription
responseNmcSubjectResultrequired

NmcSubjectResult

FieldTypeRequiredConstraintsDescription
headerKrDataHeaderrequired
↳resultCodestringrequired결과 코드. 정상은 00
↳resultMsgstringrequired결과 메시지
bodyNmcSubjectBodyrequired
↳itemsNmcSubjectItemsrequired
↳itemNmcSubjectItem[]required
↳subjectCdstringrequired진료과목 코드 (코드마스터 D000)
↳subjectNmstringoptional진료과목명
↳numOfRowsnumberrequired한 페이지 결과 수
↳pageNonumberrequired페이지 번호
↳totalCountnumberrequired전체 결과 수
{
  "response": {
    "header": {
      "resultCode": "00",
      "resultMsg": "NORMAL SERVICE."
    },
    "body": {
      "items": {
        "item": [
          {
            "subjectCd": "D001",
            "subjectNm": "내과"
          }
        ]
      },
      "numOfRows": 25,
      "pageNo": 1,
      "totalCount": 25
    }
  }
}

Playground​

Server
Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI

달빛어린이병원 목록 조회​

GET
/data-go-kr/nmc/baby-hospitals

로컬 DB 에 미러링한 달빛어린이병원·소아전문센터. 응답 구조는 원본 API 와 동일하다.

Request

🔒 Bearer 인증 필요 · 인증 방법
GET/data-go-kr/nmc/baby-hospitals

Query Parameters

NameTypeRequiredConstraintsDescription
pagenumberoptionaldefault 1페이지 번호
sizenumberoptionalmin 1 · max 100 · default 20페이지 크기

Response

200

NmcBabyHospitalListResponse

FieldTypeRequiredConstraintsDescription
responseNmcBabyHospitalListResultoptional

NmcBabyHospitalListResult

FieldTypeRequiredConstraintsDescription
headerNmcResultHeaderoptional
↳resultCodestringoptional결과코드 (정상: 00)
↳resultMsgstringoptional결과메시지
bodyNmcBabyHospitalListBodyoptional
↳numOfRowsintegeroptional한 페이지 결과 수
↳pageNointegeroptional현재 페이지 번호
↳totalCountintegeroptional전체 결과 수
↳itemsNmcBabyHospitalListItemsoptional
↳itemNmcHospitalListItem[]optional
↳rnumintegeroptional일련번호
↳hpidstringoptional기관ID
↳dutyNamestringoptional기관명
↳dutyAddrstringoptional주소
↳dutyDivNmcDutyDivoptional
↳dutyDivNamstringoptional병원분류명
↳dutyEmclsstringoptional응급의료기관코드
↳dutyEmclsNamestringoptional응급의료기관코드명
↳dutyErynstringoptional응급실운영여부 (1:운영, 2:미운영)
↳dutyEtcstringoptional비고
↳dutyInfstringoptional기관설명상세
↳dutyMapimgstringoptional간이약도
↳dutyTel1stringoptional대표전화1
↳dutyTel3stringoptional응급실전화
↳postCdn1stringoptional우편번호1
↳postCdn2stringoptional우편번호2
↳wgs84Lonstringoptional병원경도
↳wgs84Latstringoptional병원위도
↳dutyTime1sstringoptional진료시간(월요일) 시작
↳dutyTime2sstringoptional진료시간(화요일) 시작
↳dutyTime3sstringoptional진료시간(수요일) 시작
↳dutyTime4sstringoptional진료시간(목요일) 시작
↳dutyTime5sstringoptional진료시간(금요일) 시작
↳dutyTime6sstringoptional진료시간(토요일) 시작
↳dutyTime7sstringoptional진료시간(일요일) 시작
↳dutyTime8sstringoptional진료시간(공휴일) 시작
↳dutyTime1cstringoptional진료시간(월요일) 종료
↳dutyTime2cstringoptional진료시간(화요일) 종료
↳dutyTime3cstringoptional진료시간(수요일) 종료
↳dutyTime4cstringoptional진료시간(목요일) 종료
↳dutyTime5cstringoptional진료시간(금요일) 종료
↳dutyTime6cstringoptional진료시간(토요일) 종료
↳dutyTime7cstringoptional진료시간(일요일) 종료
↳dutyTime8cstringoptional진료시간(공휴일) 종료
↳sidoNmstringoptional시도명 (예: 서울특별시). **원본 API 에는 없는 파생 필드다.** 주소(dutyAddr)의 첫 토큰에서 추출하며, 축약 표기(서울)는 정식 명칭(서울특별시)으로 정규화한다.
↳sgguNmstringoptional시군구명 (예: 강남구). **원본 API 에는 없는 파생 필드다.** 주소(dutyAddr)의 둘째 토큰에서 추출한다. 시 아래 구가 있으면 두 토큰을 합친다(예: 수원시 팔달구). 세종특별자치시처럼 시군구가 없는 지역은 값이 없다.
{
  "response": {
    "header": {
      "resultCode": "string",
      "resultMsg": "string"
    },
    "body": {
      "numOfRows": 0,
      "pageNo": 0,
      "totalCount": 0,
      "items": {
        "item": [
          {
            "rnum": 0,
            "hpid": "string",
            "dutyName": "string",
            "dutyAddr": "string",
            "dutyDiv": "string",
            "dutyDivNam": "string",
            "dutyEmcls": "string",
            "dutyEmclsName": "string",
            "dutyEryn": "string",
            "dutyEtc": "string",
            "dutyInf": "string",
            "dutyMapimg": "string",
            "dutyTel1": "string",
            "dutyTel3": "string",
            "postCdn1": "string",
            "postCdn2": "string",
            "wgs84Lon": "string",
            "wgs84Lat": "string",
            "dutyTime1s": "string",
            "dutyTime2s": "string",
            "dutyTime3s": "string",
            "dutyTime4s": "string",
            "dutyTime5s": "string",
            "dutyTime6s": "string",
            "dutyTime7s": "string",
            "dutyTime8s": "string",
            "dutyTime1c": "string",
            "dutyTime2c": "string",
            "dutyTime3c": "string",
            "dutyTime4c": "string",
            "dutyTime5c": "string",
            "dutyTime6c": "string",
            "dutyTime7c": "string",
            "dutyTime8c": "string",
            "sidoNm": "서울특별시",
            "sgguNm": "강남구"
          }
        ]
      }
    }
  }
}

Playground​

Server
Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI