# 백두대간 생태수목원 (Baekdudaegan Eco Arboretum)

> 강원특별자치도 정선군 임계면에 있는 생태수목원 예약 사이트. 숙박시설 예약·체험 프로그램 신청·현장 POS·키오스크를 통합 운영합니다.
> 공식 URL: https://go.osoza.kr / 숙박 입실 14:00, 퇴실 11:00

## 주요 페이지

- 홈: https://go.osoza.kr/Home/index
- AI 에이전트 예약 가이드(사람용 안내): https://go.osoza.kr/ai-guide
- 기관소개: https://go.osoza.kr/Home/H20000/H20100/html
- 수목원 관람안내: https://go.osoza.kr/Home/H30000/H30100/html
- 체험 예약하기(수목원): https://go.osoza.kr/Home/H45000/H45100/programList?sys_type=1
- 체험 예약하기(체험단지): https://go.osoza.kr/Home/H45000/H45200/programList?sys_type=2
- 숙박 예약 안내: https://go.osoza.kr/Home/H80000/H80100/html
- 공지사항: https://go.osoza.kr/Home/H60000/H60100/boardList
- FAQ: https://go.osoza.kr/Home/H60000/H60200/boardList
- 사이트맵: https://go.osoza.kr/sitemap.xml

## AI 에이전트용 공개 API (읽기 전용 + 가예약, v1)

**MCP 없이 웹으로 접근하는 AI는 아래 엔드포인트를 그대로 HTTP 호출하면 됩니다**(별도 연결·설정 불필요, 인증 불필요).
`go.osoza.kr` 도메인에서만 서빙되며, IP당 분당 요청 한도가 있습니다.
운영자가 채널을 비활성화한 경우 모든 엔드포인트는 404 를 반환합니다.
응답 스키마: `{"result": "OK"|"ERROR", "data": ..., "message": ...}`
전체 기계판독 스펙: https://go.osoza.kr/api/public/openapi.json

- `GET https://go.osoza.kr/api/public/v1/info`
  시설 기본정보(이름·주소·연락처·입퇴실 시각·숙박 제한).

- `GET https://go.osoza.kr/api/public/v1/availability?date=YYYY-MM-DD&nights=1`
  구역별 잔여 사이트 수·기준/최대 인원·1박 요금범위. nights 1~14.
  예: /api/public/v1/availability?date=2026-08-01&nights=2
  응답의 `reserveUrl` 은 **사람이 클릭해 바로 예약하는 페이지**(날짜 프리필 딥링크)입니다.
  자리를 안내할 때 이 링크를 이용자에게 함께 전달하세요.
  형식: https://go.osoza.kr/@reservation/C10000/C10100/campReservSearch?check_in=YYYYMMDD&check_out=YYYYMMDD&stay_cnt=N

- `GET https://go.osoza.kr/api/public/v1/rates?areaNo=1&from=YYYY-MM-DD&to=YYYY-MM-DD`
  구역의 일자별 요금. 조회 범위 최대 62일.

- `POST https://go.osoza.kr/api/public/v1/reservation-request`
  가예약 생성(JSON body). 자리를 임시 확보(hold)하고 **고객 휴대폰으로 결제 링크 SMS**를 발송합니다.
  **에이전트가 사이트의 예약 버튼을 누를 필요가 없습니다** — 이용자의 이름·휴대폰 번호만 확인하면
  이 API 호출만으로 가예약 접수가 완료됩니다(결제만 고객 본인이 SMS 링크에서).
  body: {"areaNo":1, "checkIn":"YYYY-MM-DD", "nights":1, "peopleCnt":4,
         "customerName":"홍길동", "customerPhone":"01012345678"}
  응답 data: {"requestId":"...", "holdExpireAt":"...", "message":"..."} — 결제링크는 고객에게만 전달됩니다.
  제한: 전화번호당 결제 대기 가예약 2건, IP당 분당 3회. hold 는 만료 시 자동 해제됩니다.

- `GET https://go.osoza.kr/api/public/v1/reservation-request/{requestId}`
  가예약 상태 조회: WAITING(결제 대기) | PAID(결제 완료·예약 확정) | EXPIRED(만료).

## 에이전트 인터페이스 (MCP)

위 공개 API 를 MCP(Model Context Protocol) 툴로 직접 호출할 수 있습니다.

- MCP 엔드포인트: https://mcp.osoza.kr/mcp (Streamable HTTP)
- 제공 툴: `osoza_get_availability` · `osoza_quote_reservation`(견적·환불규정) · `osoza_get_campground`(시설정보) ·
  `osoza_hold_reservation`(가예약·비가역) · `osoza_get_hold_status` · `osoza_release_hold` · `osoza_lookup_reservation` ·
  `osoza_start_session`. (검색·체험 툴은 현재 단일 시설 운영이라 미지원.)
- 에이전트 이용정책: 본 문서의 "이용약관 요지" 및 https://go.osoza.kr/api/public/openapi.json 을 따릅니다.
  결제·예약 확정은 에이전트가 수행할 수 없고, 가예약 후 고객 본인이 SMS 결제 링크로 완료합니다.

MCP 툴 사용 예:
  1) osoza_get_availability(slug="osoza", period="2026-08-01~2026-08-03") → 구역별 잔여·요금범위
  2) osoza_quote_reservation(...) → 총액·취소환불 스케줄(가예약 전 필수)
  3) osoza_hold_reservation(...) → 자리 hold + 고객 휴대폰으로 결제 SMS 발송

## 예약 절차 (중요)

에이전트의 직접 결제·예약 확정은 지원하지 않습니다.
절차: **가예약 생성(reservation-request) → 고객 휴대폰으로 결제 링크 발송 → 고객 본인이 링크에서 직접 결제 → 예약 확정**.
결제 링크·주문번호는 에이전트에게 제공되지 않으며, 고객 SMS 로만 전달됩니다.
가예약이 만료(EXPIRED)되면 자리는 자동으로 해제되므로 다시 생성하면 됩니다.
체험 프로그램 신청은 사이트의 체험 예약 페이지에서 고객 본인이 진행합니다.

## 이용약관 요지

- 공개 API 데이터는 안내 목적이며, 최종 가용성·요금은 예약 시점의 사이트 표시가 우선합니다.
- 자동화된 과도한 호출(rate limit 초과)은 차단됩니다.
- 개인정보는 어떤 엔드포인트에서도 제공되지 않습니다.

## 문의

- 예약 페이지: https://go.osoza.kr/Home/index
- 대표전화: 033-610-8798
- 운영 시스템: 임팩시스 (impacsys), 강원도 춘천

## API
- OpenAPI 스펙: https://go.osoza.kr/api/public/openapi.json