작동 방식

이 모듈형 API는 숙박 시설 예약을 완료하는 데 필요한 모든 데이터 포인트를 제공합니다. 구축하려는 사용자 경험에 따라 지역 매핑, 숙박 시설, 요금 등에 액세스할 수 있습니다. 이 페이지에서는 예약 경로가 어떤 방식으로 작동하는지 안내합니다.

예약 요청 흐름 구축

예약 경로를 만드는 과정을 안내하기 위해 마련된 간단한 가이드입니다. 통합을 시작할 준비가 되면 API 설명서 페이지에서 각 API 모듈의 자세한 정보를 확인할 수 있습니다.

숙박 시설 카탈로그는 숙박 시설 ID, 이름 및 주소, 연락처 정보, 숙박 시설 등급 등 숙박 시설을 식별하는 데 필요한 핵심 정보를 제공합니다. 숙박 시설 콘텐츠는 매일 새로 고침해야 합니다.

지리 API를 사용하면 정의된 지리 지역, 지역 계층 구조 및 특정 지역 내에서 이용 가능한 숙박 시설 정보를 얻을 수 있습니다.

투숙 기간, 숙박 세부 정보 및 원하는 숙박 시설 ID를 사용하여 조회 API를 호출합니다.

응답으로 객실 옵션별 특정 요금, 수수료 및 취소 정책과 함께 각 숙박 시설에서 이용 가능한 모든 객실을 반환합니다. 반환된 각 객실 개체에는 예약 프로세스의 다음 단계에 바로 사용할 수 있는 토큰화된 링크도 포함됩니다.

결제 옵션 링크를 사용하여 숙박 시설에 사용 가능한 결제 옵션을 결정합니다. 결제 옵션 링크는 예약 프로세스 중 언제든지 여행객에게 지원되는 결제 옵션을 표시하기로 선택한 시점에 사용할 수 있습니다.

예약을 준비하려면 조회 응답의 room 개체에서 price_checklink를 사용하여 선택한 요금을 확인합니다.

요금이 일치하는 경우 MATCHED 확인과 예약 요청에 필요한 링크 값을 받게 됩니다. 요금이 변경되면 새 요금 정보와 새로운 요금으로 예약할 링크 값을 받게 됩니다.

예약 링크 값, 고객 정보 및 적절한 결제 정보와 함께 예약 요청을 전송합니다.

응답은 예약 세부 정보를 검색하거나 예약을 취소하거나 예약을 재개(보류된 예약이 생성된 경우)하는 링크와 일정 ID를 반환합니다.

나중에 예약을 보다 빠르게 검색할 수 있도록 여행객 정보에 대한 검색 링크를 저장하는 것이 좋습니다.

최종 예약 확인 페이지에 모든 정보를 추가하기만 하면 됩니다. 예약 경로를 모두 구성했습니다.

전체 일정 기록을 검색하려면 예약 응답에 제공된 검색 링크를 사용합니다.

검색 응답은 모든 날짜, 요금, 예약된 객실 유형, 확인 번호 및 예약의 현재 상태를 확인합니다.

검색을 통해 숙박 시설과 직접 통신하는 데 사용하는 양방향 메시지 전송 도구인 숙박 시설 메시지 센터 링크를 가져옵니다. 검색 응답에는 이름, 흡연/금연 선호 사항 또는 특별 요청과 같은 객실 세부 정보를 변경할 수 있는 옵션도 포함됩니다.