예약

예약 API를 사용하여 요금 확인 응답을 통해 확정된 요금으로 객실을 예약할 수 있습니다.

예약 API의 기본 일정 메서드는 선택한 숙박 시설, 객실, 요금, 투숙 인원에 대한 예약을 생성합니다. 청구/카드 소유자 연락처 정보를 포함한 결제 정보는 요청에 직접 제공됩니다.

각 예약 응답에는 일정 검색 또는 예약 취소 링크가 포함되어 있습니다. 자세한 내용은 예약 관리 섹션과 예약 요청 처리하기 페이지를 참조하세요.

multi-room 예약(동일한 객실 유형)을 하려면 먼저 조회 API 요청을 하고 각 객실마다 별도의 occupancy 파라미터를 전달해야 합니다. 그런 다음 예약 요청에 예약하려는 각 객실의 room 배열에 해당하는 별도의 rooms 인스턴스를 포함하세요.

예약을 완료하기 전에 잠시 재고를 보류하려면(예: 패키지 구성) 보류 및 재개 설명서를 참조해 주세요.

카드에 청구되지 않거나 숙박 시설로 전송되지 않는 테스트 예약을 생성하려면 테스트 요청 설명서를 참조해 주세요.

예약 링크 만료

이전 요금 확인 응답의 예약 링크는 곧 만료됩니다. 첫 시도에서 HTTP 503 오류 메시지가 표시되면 해당 링크가 만료된 것일 수 있습니다. 새 링크를 받은 후 예약을 다시 시도해 주세요.

INR 및 BRL 예약에 대한 세금 ID

규정상 세금 요건으로 인해 인도 루피(INR) 및 브라질 헤알(BRL)로 이루어진 일부 Rapid API 거래에는 tax_registration_number 매개변수에 결제 여행자의 유효한 개인 세금 ID를 입력해야 합니다.

이 매개변수를 비워두거나 잘못된 세금 ID를 제공하면 예약 생성 API의 요청이 실패할 수 있습니다. 이 경우, 요청은 오류의 원인을 tax_registration_number로 설명하는 메시지와 함께 HTTP 400 오류를 반환합니다. 이 오류는 tax_registration_number를 유효한 세금 ID로 업데이트하고 예약 생성 요청을 재전송해 수정되어야 합니다.

제재 사항

제재는 차단된 당사자에 대한 경제 및 거래 제한 조치입니다. 유엔에는 이라크, 이란, 수단, 예멘, ISIL( Al-Qaida, ) 및 탈레반에 대한 제재를 포함하여 30개의 제재 체제가 있습니다. 미국, EU, 영국도 테러리스트, 마약 밀매자, 국가 안보 위협을 겨냥한 자체 제재를 시행하고 있습니다. 미국, EU 또는 유엔 회원국에 설립된 기업은 이러한 제재를 준수해야 합니다.

Rapid는 어떻게 제재를 준수하나요?

예약 시 생년월일, 성명, 주소 등 여행자에 대한 추가 세부 정보를 캡처할 수 있는 기능을 추가했습니다. 이러한 세부 정보는 사기 및 위험 팀에서 제재 심사를 위해 사용하는 사례 관리 도구에 수집됩니다.

제재 심사를 위한 추가 필드는 예약 생성 스키마의 sensitive_traveler_details 에서 확인할 수 있습니다. 이 기능은 2026년 1월부터 적용될 예정입니다.

API 세부 정보

이 페이지에서 예약 관련 엔드포인트 정의를 살펴본 후 API Explorer 또는 다른 테스트 소프트웨어를 사용하여 예시 및 스키마 정의가 실제 출력과 어떤 차이가 있는지 확인해 보세요.

추가 리소스

모든 Rapid API 엔드포인트를 사용해 보거나 OpenAPI 사양 또는 Postman 컬렉션을 다운로드하려는 경우 다음 사항을 참조해 주세요.