참조 데이터

엔드포인트

진료과목 코드 — GET /healthcare/meta/subjects
진료 분야 그룹 — GET /healthcare/meta/subject-groups
병원 등급 — GET /healthcare/meta/tiers
종별 코드 — GET /healthcare/meta/classes
장비 코드 — GET /healthcare/meta/equipments
중증질환 처치가능 코드 — GET /healthcare/meta/severities
전문병원 지정분야 코드 — GET /healthcare/meta/specialties
특수진료 코드 — GET /healthcare/meta/specials
건강보험심사평가원 적정성평가 분야·항목 — GET /healthcare/meta/assessments

진료과목 코드

GET

/healthcare/meta/subjects

병원 검색의 subject 파라미터에 쓴다. 각 과목에 계열(field: 의/치/한)과 전문과목 여부(specialist)가 붙는다 — 화면이 계열로 그룹핑하고, 전문의 필터는 specialist=true 만 쓴다.

Request

🔒 Bearer 인증 필요 · 인증 방법

GET/healthcare/meta/subjects

Response

200

ListResponse

Field	Type	Required	Constraints	Description
`items`	MetaSubject[]	required

MetaSubject

Field	Type	Required	Constraints	Description
`code`	string	required
`name`	string	required
`description`	string	optional		설명
`field`	string	required	med, dent, km	면허 계열. med(의과) · dent(치과) · km(한방). 화면이 이걸로 그룹핑한다.
`specialist`	boolean	required		전문의 보드가 있는 과목인가. 치과(일반)·한방응급만 false. 전문의 필터는 true 인 것만 옵션으로 쓴다.

{
  "items": [
    {
      "code": "IM",
      "name": "내과",
      "description": "string",
      "field": "med",
      "specialist": true
    }
  ]
}

GET

/healthcare/meta/subjects

Playground

Server

Authorization

bearer

Samples

진료 분야 그룹

GET

/healthcare/meta/subject-groups

47개 진료과목을 이용자가 아는 이름으로 묶은 서비스 자체 분류다. 표준 코드가 아니다.

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

Request

🔒 Bearer 인증 필요 · 인증 방법

GET/healthcare/meta/subject-groups

Response

200

ListResponse

Field	Type	Required	Constraints	Description
`items`	MetaSubjectGroup[]	required

MetaSubjectGroup

Field	Type	Required	Description
`code`	string	required
`name`	string	required
`subjects`	MetaCode[]	required
↳`code`	string	required
↳`name`	string	required
↳`description`	string	optional	설명

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

GET

/healthcare/meta/subject-groups

Playground

Server

Authorization

bearer

Samples

병원 등급

GET

/healthcare/meta/tiers

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

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

Request

🔒 Bearer 인증 필요 · 인증 방법

GET/healthcare/meta/tiers

Response

200

ListResponse

Field	Type	Required	Constraints	Description
`items`	MetaHospitalTier[]	required

MetaHospitalTier

Field	Type	Required	Description
`code`	string	required	TIER1 \| TIER2 \| TIER3
`name`	string	required
`description`	string	required
`classes`	MetaCode[]	required
↳`code`	string	required
↳`name`	string	required
↳`description`	string	optional	설명

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

GET

/healthcare/meta/tiers

Playground

Server

Authorization

bearer

Samples

종별 코드

GET

/healthcare/meta/classes

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

Request

🔒 Bearer 인증 필요 · 인증 방법

GET/healthcare/meta/classes

Response

200

ListResponse

Field	Type	Required	Constraints	Description
`items`	MetaCode[]	required

MetaCode

Field	Type	Required	Description
`code`	string	required
`name`	string	required
`description`	string	optional	설명

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

GET

/healthcare/meta/classes

Playground

Server

Authorization

bearer

Samples

장비 코드

GET

/healthcare/meta/equipments

CT·MRI·PET 등

Request

🔒 Bearer 인증 필요 · 인증 방법

GET/healthcare/meta/equipments

Response

200

ListResponse

Field	Type	Required	Constraints	Description
`items`	MetaCode[]	required

MetaCode

Field	Type	Required	Description
`code`	string	required
`name`	string	required
`description`	string	optional	설명

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

GET

/healthcare/meta/equipments

Playground

Server

Authorization

bearer

Samples

중증질환 처치가능 코드

GET

/healthcare/meta/severities

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

Request

🔒 Bearer 인증 필요 · 인증 방법

GET/healthcare/meta/severities

Response

200

ListResponse

Field	Type	Required	Constraints	Description
`items`	MetaCode[]	required

MetaCode

Field	Type	Required	Description
`code`	string	required
`name`	string	required
`description`	string	optional	설명

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

GET

/healthcare/meta/severities

Playground

Server

Authorization

bearer

Samples

전문병원 지정분야 코드

GET

/healthcare/meta/specialties

관절·척추·심장 등. 보건복지부가 지정한 전문병원의 분야다.

병원 상세의 capabilities(type=specialty) 코드를 이 이름으로 푼다.

Request

🔒 Bearer 인증 필요 · 인증 방법

GET/healthcare/meta/specialties

Response

200

ListResponse

Field	Type	Required	Constraints	Description
`items`	MetaCode[]	required

MetaCode

Field	Type	Required	Description
`code`	string	required
`name`	string	required
`description`	string	optional	설명

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

GET

/healthcare/meta/specialties

Playground

Server

Authorization

bearer

Samples

특수진료 코드

GET

/healthcare/meta/specials

방문진료·재택의료·치매주치의·중환자실 운영 등. 대부분 시범사업이다.

병원 상세의 capabilities(type=special) 코드를 이 이름으로 푼다.

Request

🔒 Bearer 인증 필요 · 인증 방법

GET/healthcare/meta/specials

Response

200

ListResponse

Field	Type	Required	Constraints	Description
`items`	MetaCode[]	required

MetaCode

Field	Type	Required	Description
`code`	string	required
`name`	string	required
`description`	string	optional	설명

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

GET

/healthcare/meta/specials

Playground

Server

Authorization

bearer

Samples

건강보험심사평가원 적정성평가 분야·항목

GET

/healthcare/meta/assessments

분야(급성질환·암질환 …) 밑에 평가항목(대장암·급성기뇌졸중 …)이 달린다. 상세 검색의 assessment 필터에 쓴다 — items 의 code 를 ?assessment=12,20 처럼 넘기면 그 항목에서 1등급(우수)을 받은 병원을 찾는다.

Request

🔒 Bearer 인증 필요 · 인증 방법

GET/healthcare/meta/assessments

Response

200

ListResponse

Field	Type	Required	Constraints	Description
`items`	MetaAssessmentGroup[]	required

MetaAssessmentGroup

Field	Type	Required	Description
`code`	string	required
`name`	string	required
`items`	MetaAssessmentItem[]	required
↳`code`	string	required
↳`name`	string	required
↳`description`	string	optional	설명
↳`scopes`	string[]	required	이 항목이 뜨는 검색 맥락. general(일반·응급·달빛·정신) \| nursing(요양). 탭에 맞는 항목만 보이게 클라이언트가 이걸로 거른다.

{
  "items": [
    {
      "code": "asm03",
      "name": "암질환",
      "items": [
        {
          "code": "IM",
          "name": "내과",
          "description": "string",
          "scopes": [
            "general"
          ]
        }
      ]
    }
  ]
}

GET

/healthcare/meta/assessments

Playground

Server

Authorization

bearer

참조 데이터 ​

엔드포인트 ​

진료과목 코드​

Request

Response

200

ListResponse

MetaSubject

Playground​

Samples​

진료 분야 그룹​

Request

Response

200

ListResponse

MetaSubjectGroup

Playground​

Samples​

병원 등급​

Request

Response

200

ListResponse

MetaHospitalTier

Playground​

Samples​

종별 코드​

Request

Response

200

ListResponse

MetaCode

Playground​

Samples​

장비 코드​

Request

Response

200

ListResponse

MetaCode

Playground​

Samples​

중증질환 처치가능 코드​

Request

Response

200

ListResponse

MetaCode

Playground​

Samples​

전문병원 지정분야 코드​

Request

Response

200

ListResponse

MetaCode

Playground​

Samples​

특수진료 코드​

Request

Response

200

ListResponse

MetaCode

Playground​

Samples​

건강보험심사평가원 적정성평가 분야·항목​

Request

Response

200

ListResponse

MetaAssessmentGroup

Playground​

Samples​

참조 데이터

엔드포인트

진료과목 코드

Playground

Samples

진료 분야 그룹

Playground

Samples

병원 등급

Playground

Samples

종별 코드

Playground

Samples

장비 코드

Playground

Samples

중증질환 처치가능 코드

Playground

Samples

전문병원 지정분야 코드

Playground

Samples

특수진료 코드

Playground

Samples

건강보험심사평가원 적정성평가 분야·항목

Playground

Samples