{
  "openapi": "3.1.0",
  "info": {
    "title": "연결한의원 청주오창 공개 정보 API",
    "description": "한의원 기본 정보와 건강칼럼 목록을 제공하는 읽기 전용 공개 API입니다. 예약 생성이나 환자정보 처리는 지원하지 않습니다.",
    "version": "1.0.0"
  },
  "servers": [{"url": "https://www.yeongyeolochang.co.kr"}],
  "paths": {
    "/api/v1/clinic": {
      "get": {
        "operationId": "getClinicInformation",
        "summary": "한의원 기본 정보 조회",
        "description": "주소, 전화번호, 진료시간과 공식 예약 링크를 반환합니다.",
        "responses": {
          "200": {"description": "한의원 기본 정보", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Clinic"}}}},
          "500": {"description": "서버에서 정보를 불러오지 못함", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}
        }
      }
    },
    "/api/v1/columns": {
      "get": {
        "operationId": "listHealthColumns",
        "summary": "건강칼럼 목록 조회",
        "description": "증상명, 분류, 요약과 공개 칼럼 URL을 반환합니다.",
        "responses": {
          "200": {"description": "건강칼럼 목록", "content": {"application/json": {"schema": {"type": "array", "items": {"$ref": "#/components/schemas/Column"}}}}},
          "500": {"description": "서버에서 칼럼 목록을 불러오지 못함", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}
        }
      }
    },
    "/api/v1/postpartum": {
      "get": {
        "operationId": "listPostpartumColumns",
        "summary": "산후보약·산후한약 건강칼럼 목록 조회",
        "description": "산후 건강칼럼 제목, 요약과 공개 원문 URL을 반환합니다.",
        "responses": {
          "200": {"description": "산후 건강칼럼 목록", "content": {"application/json": {"schema": {"type": "array", "items": {"$ref":"#/components/schemas/PostpartumColumn"}}}}},
          "500": {"description": "서버에서 산후 칼럼 목록을 불러오지 못함", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Clinic": {"type": "object", "description":"공개된 한의원 기본 정보와 공식 연락·예약 경로입니다.", "required": ["name","phone","address","hours"], "properties": {"name":{"type":"string","description":"한의원 공식 명칭"},"director":{"type":"string","description":"대표원장 성명"},"phone":{"type":"string","description":"대표 전화번호"},"address":{"type":"string","description":"도로명 주소와 호수"},"hours":{"type":"string","description":"요일별 진료시간"},"openingNote":{"type":"string","description":"휴일 및 점심시간 안내"},"bookingUrl":{"type":"string","format":"uri","description":"공식 네이버 예약 주소"},"mapUrl":{"type":"string","format":"uri","description":"공식 네이버 지도 주소"},"kakaoUrl":{"type":"string","format":"uri","description":"공식 카카오톡 채널 주소"}}},
      "Column": {"type":"object","description":"증상별 건강칼럼과 지역별 공개 원문 주소입니다.","required":["name","category","summary","pages"],"properties":{"name":{"type":"string","description":"건강 주제 또는 증상명"},"category":{"type":"string","description":"칼럼 분류"},"summary":{"type":"string","description":"칼럼의 핵심 요약"},"pages":{"type":"array","description":"청주와 오창 지역별 원문","items":{"type":"object","properties":{"region":{"type":"string","description":"지역명"},"url":{"type":"string","format":"uri","description":"공개 칼럼 원문 주소"}}}}}},
      "PostpartumColumn": {"type":"object","description":"산후 건강관리와 산후한약 상담 기준을 다룬 공개 칼럼입니다.","required":["title","summary","url"],"properties":{"title":{"type":"string","description":"산후 건강칼럼 제목"},"summary":{"type":"string","description":"칼럼 핵심 요약"},"url":{"type":"string","format":"uri","description":"공개 칼럼 원문 주소"}}},
      "Error": {"type":"object","description":"API 요청을 처리하지 못했을 때 반환되는 오류 정보입니다.","required":["error","message"],"properties":{"error":{"type":"string","description":"기계가 읽을 수 있는 오류 코드"},"message":{"type":"string","description":"오류 상황을 설명하는 메시지"}}}
    }
  }
}