# 한국 병원 대사전 (Korean Hospital Encyclopedia)

> 전국 의료기관 정보를 동(洞)과 지하철역 기준으로 제공하는 디렉토리. 건강보험심사평가원(HIRA) 공공데이터 기반, 총 79487개 병원 수록.

## 사이트 개요

본 사이트는 한국의 의료기관 정보를 지역(동) 및 지하철역 기준으로 구조화하여 제공합니다.
- 데이터 출처: 건강보험심사평가원 (Health Insurance Review & Assessment Service, HIRA) 공공데이터
- 데이터 범위: 전국 의료기관 기본정보, 진료과목, 전문의 수, 비급여 가격
- 데이터 갱신: 정기적 배치 수집 (비급여 가격 연 1-2회, 기본정보 수시)
- 면책: 본 정보는 공공데이터 기반이며, 실제와 다를 수 있습니다

## API 엔드포인트

### URL 패턴

| 페이지 타입 | HTML URL | JSON API URL |
|---|---|---|
| 전체 인덱스 | — | `/api/index.json` (모든 JSON 엔드포인트 색인) |
| 동 × 진료과 | `/{sido}/{gu}/{dong}/{dept}` | `/{sido}/{gu}/{dong}/{dept}.json` |
| 역 × 진료과 | `/{line}/{station}/{dept}` | `/{line}/{station}/{dept}.json` |

URL slug는 영문 로마자 kebab-case입니다.

### HTTP 응답 헤더 (모든 JSON 엔드포인트 공통)

- `Content-Type: application/json; charset=utf-8`
- `Cache-Control: public, max-age=3600, stale-while-revalidate=86400`
- `Access-Control-Allow-Origin: *` (CORS 개방 — 직접 fetch 가능)
- `Link: <canonical HTML URL>; rel="canonical"; type="text/html"`
- `X-Robots-Tag: index, follow`

### 예시 URL

- API 인덱스: https://clinics.seoul.kr/api/index.json
- 동 페이지: https://clinics.seoul.kr/seoul/gangnam-gu/yeoksam-dong/dental
- 동 JSON API: https://clinics.seoul.kr/seoul/gangnam-gu/yeoksam-dong/dental.json
- 역 페이지: https://clinics.seoul.kr/line-2/yeoksam-station/dental
- 역 JSON API: https://clinics.seoul.kr/line-2/yeoksam-station/dental.json

## JSON API 응답 스키마

### 동 페이지 응답 (DongApiResponse)

```json
{
  "meta": {
    "region": "역삼동",
    "department": "치과",
    "hospitalCount": 47,
    "lastUpdated": "2026-04-22",
    "source": {
      "name": "건강보험심사평가원",
      "organization": "Health Insurance Review & Assessment Service (HIRA)",
      "url": "https://www.hira.or.kr",
      "license": "KOGL Type 1 (공공누리 제1유형)",
      "licenseUrl": "https://www.kogl.or.kr/info/license.do#01-tab"
    },
    "canonicalUrl": "https://clinics.seoul.kr/seoul-teukbyeolsi/gangnam-gu/yeoksam-dong/dental",
    "self": "https://clinics.seoul.kr/seoul-teukbyeolsi/gangnam-gu/yeoksam-dong/dental.json",
    "publisher": "한국 병원 대사전 (Korean Hospital Encyclopedia)",
    "publisherUrl": "https://clinics.seoul.kr"
  },
  "stats": {
    "specialistRatio": 0.72,
    "priceRange": { "min": 800000, "avg": 1200000, "max": 1800000, "item": "임플란트" }
  },
  "hospitals": [
    {
      "name": "서울바른치과",
      "address": "서울 강남구 역삼동 123-45",
      "phone": "02-555-1234",
      "homepageUrl": "https://seoulbarun.example",
      "ogImageUrl": "https://cdn.example/og.jpg",
      "ogTitle": "서울바른치과 공식 홈페이지",
      "specialistCount": 3,
      "departments": ["치과"],
      "prices": [{ "item": "임플란트", "min": 900000, "max": 1500000 }]
    }
  ]
}
```

### 역 페이지 추가 필드 (StationApiResponse)

역 페이지 응답은 동 페이지와 동일한 구조에 다음 필드가 hospitals 배열 내 각 항목에 추가됩니다:

```json
{
  "walkMinutes": 5,
  "distanceMeters": 350
}
```

### JSON 필드 규칙

- 필드명: camelCase
- 날짜: ISO 8601 (YYYY-MM-DD)
- 가격: 정수 원(KRW) 단위
- null 값: 필드 자체 생략
- 빈 배열: `[]`로 전송
- 병원 0개: `hospitals: []`, stats 필드 생략

### 필드 상세

| 필드 | 타입 | 설명 |
|---|---|---|
| meta.region | string | 동 이름 또는 역 이름 |
| meta.department | string | 진료과 한글명 |
| meta.hospitalCount | number | 해당 지역 병원 수 |
| meta.lastUpdated | string | 데이터 최신 갱신일 (hospitals·specialties·homepages 테이블 MAX updatedAt 기준, YYYY-MM-DD) |
| meta.source | object | `{name, organization, url, license, licenseUrl}` 구조. 라이선스는 KOGL Type 1 |
| meta.canonicalUrl | string | 대응 HTML 페이지의 canonical URL |
| meta.self | string | 이 JSON 리소스의 self URL |
| meta.publisher | string | 발행처("한국 병원 대사전") |
| meta.publisherUrl | string | 발행처 사이트 URL |
| stats.specialistRatio | number | 전문의 비율 (0~1) |
| stats.priceRange.min | number | 최저 가격 (원) |
| stats.priceRange.avg | number | 평균 가격 (원) |
| stats.priceRange.max | number | 최고 가격 (원) |
| stats.priceRange.item | string | 가격 항목명 |
| hospitals[].name | string | 병원명 |
| hospitals[].address | string? | 주소 (없으면 필드 생략) |
| hospitals[].phone | string? | 전화번호 (없으면 필드 생략) |
| hospitals[].homepageUrl | string? | 병원 공식 홈페이지 URL (네이버 로컬 기반 수집, 없으면 생략) |
| hospitals[].ogImageUrl | string? | 홈페이지 OG 이미지 URL (없으면 생략) |
| hospitals[].ogTitle | string? | 홈페이지 OG 타이틀 (없으면 생략) |
| hospitals[].specialistCount | number | 전문의 수 |
| hospitals[].departments | string[] | 진료과 목록 |
| hospitals[].prices | array | 비급여 가격 목록 |
| hospitals[].walkMinutes | number | 도보 시간 (분, 역 페이지만) |
| hospitals[].distanceMeters | number | 거리 (미터, 역 페이지만) |

## 진료과 전체 목록

| 코드 | 한글명 | 영문 slug |
|---|---|---|
| 14 | 피부과 | dermatology |
| 12 | 안과 | ophthalmology |
| 08 | 성형외과 | plastic-surgery |
| 01 | 내과 | internal-medicine |
| 03 | 정신건강의학과 | psychiatry |
| 00 | 일반의 | general-practice |
| 02 | 신경과 | neurology |
| 13 | 이비인후과 | otolaryngology |
| 15 | 비뇨의학과 | urology |
| 16 | 영상의학과 | radiology |
| 17 | 방사선종양학과 | radiation-oncology |
| 18 | 병리과 | pathology |
| 19 | 진단검사의학과 | laboratory-medicine |
| 20 | 결핵과 | tuberculosis |
| 22 | 핵의학과 | nuclear-medicine |
| 24 | 응급의학과 | emergency-medicine |
| 25 | 직업환경의학과 | occupational-medicine |
| 26 | 예방의학과 | preventive-medicine |
| 40 | 한방내과 | korean-internal-medicine |
| 50 | 구강악안면외과 | oral-maxillofacial-surgery |
| 51 | 치과보철과 | prosthodontics |
| 52 | 치과교정과 | orthodontics |
| 53 | 소아치과 | pediatric-dentistry |
| 54 | 치주과 | periodontics |
| 55 | 치과보존과 | conservative-dentistry |
| 56 | 구강내과 | oral-medicine |
| 57 | 영상치의학과 | oral-radiology |
| 58 | 구강병리과 | oral-pathology |
| 59 | 예방치과 | preventive-dentistry |
| 06 | 신경외과 | neurosurgery |
| 07 | 심장혈관흉부외과 | cardiothoracic-surgery |
| 80 | 한방내과 | korean-internal-medicine |
| 61 | 통합치의학과 | comprehensive-dentistry |
| 81 | 한방부인과 | korean-gynecology |
| 82 | 한방소아과 | korean-pediatrics |
| 83 | 한방안·이비인후·피부과 | korean-ophthalmology-ent-dermatology |
| 84 | 한방신경정신과 | korean-neuropsychiatry |
| 85 | 침구과 | acupuncture |
| 86 | 한방재활의학과 | korean-rehabilitation |
| 87 | 사상체질과 | sasang-constitution |
| 88 | 한방응급 | korean-emergency |
| 21 | 재활의학과 | rehabilitation-medicine |
| 23 | 가정의학과 | family-medicine |
| 11 | 소아청소년과 | pediatrics |
| 04 | 외과 | surgery |
| 05 | 정형외과 | orthopedics |
| 09 | 마취통증의학과 | anesthesiology |
| 49 | 치과 | dental |
| 10 | 산부인과 | obstetrics-gynecology |

## 지역 (시/도) 목록

| 코드 | 한글명 | 영문 slug |
|---|---|---|
| 110000 | 서울특별시 | seoul-teukbyeolsi |
| 210000 | 부산광역시 | busan-gwangyeoksi |
| 220000 | 인천광역시 | incheon-gwangyeoksi |
| 230000 | 대구광역시 | daegu-gwangyeoksi |
| 240000 | 광주광역시 | gwangju-gwangyeoksi |
| 250000 | 대전광역시 | daejeon-gwangyeoksi |
| 260000 | 울산광역시 | ulsan-gwangyeoksi |
| 310000 | 경기도 | gyeonggi-do |
| 320000 | 강원특별자치도 | gangwon-teukbyeoljachido |
| 330000 | 충청북도 | chungcheongbuk-do |
| 340000 | 충청남도 | chungcheongnam-do |
| 350000 | 전북특별자치도 | jeonbuk-teukbyeoljachido |
| 360000 | 전라남도 | jeollanam-do |
| 370000 | 경상북도 | gyeongsangbuk-do |
| 380000 | 경상남도 | gyeongsangnam-do |
| 390000 | 제주특별자치도 | jeju-teukbyeoljachido |
| 410000 | 세종특별자치시 | sejong-teukbyeoljachisi |

## 데이터 출처 상세

- **기관:** 건강보험심사평가원 (Health Insurance Review & Assessment Service, HIRA)
- **API:** 공공데이터포털 OpenAPI
- **수집 항목:**
  - API 1: 병원 기본정보 (명칭, 주소, 전화번호, 좌표)
  - API 2: 진료과목 및 전문의 수
  - API 3: 비급여 진료비용
  - API 4: 휴폐업 확인
- **갱신 주기:** 기본정보 수시, 비급여 가격 연 1-2회
- **면책:** 본 정보는 공공데이터 기반이며, 실제와 다를 수 있습니다