숙박 API
숙박 API는 호텔 객실, 서비스 아파트, 휴가용 주택, 호스텔, 게스트하우스 등 모든 유형의 숙소를 예약 사이트로 전달합니다. 이 페이지에서는 숙박의 기반이 되는 데이터, 렌탈이 호텔과 다른 규칙, 그리고 PHPTRAVELS가 자체 숙소와 공급사 재고를 하나의 검색에서 판매하는 방법을 설명합니다.
데이터 모델
300실 규모의 호텔이든 해변의 집 한 채든, 숙박 API는 같은 네 개의 중첩 계층으로 설명합니다. 각 계층은 투숙객이 예약 전에 묻는 서로 다른 질문에 답합니다.
01숙소
장소 자체입니다. 이름, 유형, 주소와 지도 위치, 사진, 편의시설, 성급 또는 품질 등급, 이용 규칙, 체크인 시간.
property_id · type · address · geo · photos · amenities · check_in_from
02객실 또는 유닛
실제로 예약되는 대상입니다. 객실 유형, 아파트 한 채, 도미토리의 침대 하나이며 면적, 침대, 최대 수용 인원을 갖습니다.
unit_id · beds · size_m2 · max_adults · max_children
03요금제
그 유닛의 판매 방식입니다. 식사 조건, 취소 정책, 결제 조건, 공개용인지 에이전트 전용인지와 같은 예약 가능 대상.
rate_plan_id · board · cancel_policy · payment · channel
04예약 가능 현황
하룻밤마다 한 행입니다. 가격, 남은 유닛 수, 최소 숙박일, 그날 도착이나 출발이 가능한지 여부.
date · price · units_left · min_stay · closed_to_arrival
PHPTRAVELS는 숙박 모듈을 Stays라고 부릅니다. 같은 모델이 호텔을 훨씬 넘어서는 범위를 다루기 때문입니다. 숙소(property)는 여러 유닛을 갖고, 유닛은 하나 이상의 요금제로 판매되며, 각 요금제에는 1박 단위의 가격과 예약 가능 여부를 담은 캘린더가 있습니다. 이 네 계층을 제대로 잡으면 호스텔의 침대, 호텔 스위트, 침실 세 개짜리 빌라가 모두 같은 검색과 결제에 들어맞습니다.
공급사마다 계층의 이름이 다르고 두 계층을 합치는 곳도 있지만, 구조는 언제나 존재합니다. 숙소이 모든 공급원을 이 구조에 매핑하므로, 투숙객에게는 일관된 페이지가 보입니다.
하룻밤 단위로
모든 숙박 API는 결국 캘린더로 이어집니다. 요청한 숙박 기간의 모든 밤이 예약 가능하고, 가격이 설정되어 있으며, 숙박 규칙에 맞을 때만 검색에서 숙소가 반환됩니다.
간략하게 정리한 예시 데이터입니다
숙박이 모두 호텔은 아닙니다
데이터 모델은 같지만, 숙박 유형마다 채우는 방식이 다릅니다. 호텔 객실 외의 숙소를 판매할 때 예약 흐름이 처리해야 하는 차이는 다음과 같습니다.
호스텔과 게스트하우스 포함
아파트 호텔과 도심 아파트
휴가용 주택, 빌라, 캐빈
자체 계약이 아니라 여러 호스트의 숙소를 판매하나요? 그것은 마켓플레이스이며 BnB 포털 페이지에서 다룹니다.
취소 정책 기간
취소 정책은 도착일에서 거꾸로 센 타임라인입니다. 각 기간은 그 안에서 취소할 때 투숙객이 돌려받는 금액을 정합니다.
자체 재고와 API 재고
대부분의 숙박 판매자는 둘 다 합니다. 직접 계약한 곳은 직접 등록하고, 나머지는 공급사 API로 채웁니다. 여행자는 숙소가 어디에서 왔는지 알 필요가 없습니다.
채널 매니저 연결은 채널 매니저 연동에서 다룹니다. 계약으로 확보한 객실은 예약 재고 관리 시스템를 참고하세요.
PHPTRAVELS에 준비됨
다음 숙박 공급사는 현재 Stays 모듈에 연결되어 있습니다. 공급사와 계약하고, 관리자 화면에 본인의 인증 정보를 입력하고, 샌드박스에서 테스트한 뒤 라이브로 전환하면 됩니다. 이 목록은 연동 디렉터리에서 실시간으로 가져옵니다.
지역 렌탈 네트워크처럼 목록에 없는 공급사가 필요하신가요? 문서가 있는 숙박 API라면 무엇이든 추가할 수 있습니다. 맞춤형 API 연동를 참고하세요. 호텔 공급사 유형과 콘텐츠 매핑은 호텔 API 페이지에서, 대표적인 두 베드뱅크 가이드는 RateHawk API 연동와 Hotelbeds API 연동에서 읽어 보세요.
Agoda연동 가이드
Amadeus
Booking.com연동 가이드
Hotelbeds연동 가이드
Hotelston연동 가이드
RateHawk연동 가이드
Stuba
TBO Holidays연동 가이드
Travelport
Wanderbeds숙박 API는 예약 사이트가 숙소를 검색하고, 특정 날짜와 인원에 대한 가격과 예약 가능 현황을 조회하며, 예약을 생성, 조회, 취소할 수 있게 하는 웹 서비스 모음입니다. 호텔은 물론 아파트, 휴가용 렌탈, 호스텔, 게스트하우스 등 모든 숙박 유형을 다룹니다.
핵심 호출은 같습니다. 숙박 API는 호텔이 아닌 숙소에 필요한 요소도 처리해야 합니다. 건물 전체 예약, 최소 숙박일과 교체일, 추가 인원 요금, 청소비, 환불 가능한 보증금, 도착 전에 보내는 체크인 안내 등입니다.
네. PHPTRAVELS의 Stays 모듈은 모든 숙박 유형에 숙소, 유닛, 요금제, 예약 가능 현황이라는 하나의 모델을 사용하므로, 호텔과 아파트와 휴가용 주택이 각자의 규칙을 유지한 채 같은 검색에 나타납니다.
캘린더의 각 밤에 최소 숙박 기간을 지정할 수 있으며, 보통 도착일에 연결됩니다. 투숙객이 최소 기간보다 짧게 검색하면 해당 유닛은 반환되지 않습니다. 도착 불가와 출발 불가 플래그도 교체일에 같은 방식으로 작동합니다.
네. 숙소, 유닛, 요금제, 캘린더를 직접 추가하거나 소유주에게 엑스트라넷 로그인을 주거나 채널 매니저에서 요금을 받아, 공급사 재고와 함께 하나의 결과 목록에서 판매할 수 있습니다.
요금제에서 옵니다. 공급사 재고에는 공급사의 정책이 붙고, 자체 숙소에는 직접 설정한 기간이 적용됩니다. 기한은 결제 전에 투숙객에게 표시되고 바우처에도 인쇄됩니다.
아니요. 각 숙박 공급사와 직접 계약하고 관리자 화면에 본인의 인증 정보를 입력합니다. PHPTRAVELS는 예약 플랫폼, Stays 모듈, 준비된 커넥터를 제공합니다.
네. Enterprise 플랜에서는 PHPTRAVELS REST API가 연결된 모든 공급원의 검색과 예약을 하나의 형식으로 제공하며, 예약 이벤트용 웹훅과 확장을 위한 전체 소스 코드도 함께 제공합니다.
PHPTRAVELS 라이선스, 본인의 도메인, 그리고 최소 한 곳의 재고 공급원이 필요합니다. 직접 계약한 숙소, 채널 매니저, 또는 숙박 도매업체와의 공급사 계약 중 하나면 됩니다. 먼저 라이브 데모에서 전체 흐름을 확인해 보세요.
광고 측정을 위한 쿠키
어떤 광고가 방문과 문의로 이어지는지 측정하고 관련성 높은 광고를 보여 드리기 위해 Google 쿠키를 사용합니다. 허용하려면 수락을, 사이트 작동에 필요한 쿠키만 유지하려면 거부를 선택해 주세요. 개인정보 처리방침
