healthcare-meta

진료과목 코드

GET

/healthcare/meta/subjects

병원 검색의 subject 파라미터에 쓴다.

Response

200

MetaCode

Field	Type	Required	Description
code	string	필수
name	string	필수
description	string	-	설명

[
  {
    "code": "IM",
    "name": "내과",
    "description": "string"
  }
]

GET

/healthcare/meta/subjects

Playground

Server

Authorization

bearer

Samples

Powered by VitePress OpenAPI

진료 분야 그룹

GET

/healthcare/meta/subject-groups

기본 검색의 칩. 47개 진료과목을 환자가 아는 이름으로 묶은 우리 분류다.

그룹을 고르면 subjects 의 code 들을 펼쳐서 /healthcare/hospitals?subject=A,B,C 로 검색한다.
환자가 직접 가지 않는 과(영상의학·병리·진단검사 등)는 어느 그룹에도 없다.

Response

200

MetaSubjectGroup

Field	Type	Required	Description
code	string	필수
name	string	필수
subjects	MetaCode[]	필수

MetaCode

Field	Type	Required	Description
code	string	필수
name	string	필수
description	string	-	설명

[
  {
    "code": "dental",
    "name": "치과",
    "subjects": [
      {
        "code": "IM",
        "name": "내과",
        "description": "string"
      }
    ]
  }
]

GET

/healthcare/meta/subject-groups

Playground

Server

Authorization

bearer

Samples

Powered by VitePress OpenAPI

병원 등급 (TIER1~3)

GET

/healthcare/meta/tiers

종별을 등급으로 묶은 것. 의원급(TIER1) · 병원급(TIER2) · 상급종합(TIER3).

상급종합은 진료의뢰서가 없으면 진료비 전액 본인 부담이다.
요양병원·정신병원은 이 체계 밖이라 어느 등급에도 없다(NURSING·MENTAL).

Response

200

MetaHospitalTier

Field	Type	Required	Description
code	string	필수	TIER1 | TIER2 | TIER3
name	string	필수
description	string	필수
classes	MetaCode[]	필수

MetaCode

Field	Type	Required	Description
code	string	필수
name	string	필수
description	string	-	설명

[
  {
    "code": "TIER1",
    "name": "의원급",
    "description": "외래 중심. 병상 30개 미만",
    "classes": [
      {
        "code": "IM",
        "name": "내과",
        "description": "string"
      }
    ]
  }
]

GET

/healthcare/meta/tiers

Playground

Server

Authorization

bearer

Samples

Powered by VitePress OpenAPI

종별 코드

GET

/healthcare/meta/classes

상급종합·종합병원·의원 등. 병원 검색의 category 파라미터에 쓴다.

Response

200

MetaCode

Field	Type	Required	Description
code	string	필수
name	string	필수
description	string	-	설명

[
  {
    "code": "IM",
    "name": "내과",
    "description": "string"
  }
]

GET

/healthcare/meta/classes

Playground

Server

Authorization

bearer

Samples

Powered by VitePress OpenAPI

장비 코드

GET

/healthcare/meta/equipments

CT·MRI·PET 등

Response

200

MetaCode

Field	Type	Required	Description
code	string	필수
name	string	필수
description	string	-	설명

[
  {
    "code": "IM",
    "name": "내과",
    "description": "string"
  }
]

GET

/healthcare/meta/equipments

Playground

Server

Authorization

bearer

Samples

Powered by VitePress OpenAPI

중증질환 처치가능 코드

GET

/healthcare/meta/severities

뇌출혈수술·심근경색 재관류 등. 응급 상황에서 갈 수 있는 병원을 가른다.

Response

200

MetaCode

Field	Type	Required	Description
code	string	필수
name	string	필수
description	string	-	설명

[
  {
    "code": "IM",
    "name": "내과",
    "description": "string"
  }
]

GET

/healthcare/meta/severities

Playground

Server

Authorization

bearer

Samples

Powered by VitePress OpenAPI

지역 코드

GET

/healthcare/meta/regions

level=sido 로 시도를, level=sggu&parent=11 로 그 시도의 시군구를 받는다.

Request

🔒 Bearer 인증 필요 · 인증 방법

GET/healthcare/meta/regions

Query Parameters

Name	Type	Required	Constraints	Description
level	string	-	enum: sido, sggu
parent	string	-		시도 코드 (시군구를 좁힐 때)

Response

200

MetaRegion

Field	Type	Required	Description
code	string	필수
name	string	필수	정식 명칭. **검색·매칭은 이걸 쓴다.**
shortName	string	-	화면 표시용 짧은 이름. 시도만 있다 — 시군구는 이미 짧다(강남구). 규칙으로 만들 수 없어 코드 테이블에 값으로 둔다 ("충청북도"→"충북", "전남광주통합특별시"→"전남").
level	string	필수	sido | sggu
parentCode	string	-	시도 코드. 시도면 없다.

[
  {
    "code": "11001",
    "name": "서울특별시",
    "shortName": "서울",
    "level": "sggu",
    "parentCode": "11"
  }
]

GET

/healthcare/meta/regions

Playground

Server

Authorization

bearer

Variables

Key

Value

level

parent

Samples

Powered by VitePress OpenAPI