예약 요청 처리

오류 및 손실을 방지하기 위해서는 예약 요청을 올바르게 처리하는 것이 중요합니다.

개요

네트워크 문제를 허용하기 위해서는 예약 요청 워크플로를 설계하는 것이 중요합니다. 응답 부족을 예약 실패를 나타내는 지표로 해석해서는 안 됩니다. 예약 요청이 전송된 후 응답이 수신되기 전에 인프라 문제가 발생하는 경우에도 Rapid 시스템 내에서 고객의 예약이 청구되고 확정되었을 수 있습니다. 인프라 문제는 다음과 같을 수 있습니다.

• 네트워크 연결이 끊어짐(예: 응답이 반환되지 않음)
• 서버 측 오류가 반환됨(예: HTTP 코드 500 또는 503이 반환됨)
• 잘못된 네트워크 게이트웨이가 관찰됨(예: HTTP 코드 502가 반환됨)
• 네트워크 게이트웨이 시간 초과가 관찰됨(예: HTTP 코드 504가 반환됨)
• 응답이 Rapid 설명서를 따르지 않음(예: 응답 메시지에 핵심 요소가 누락됨)
• 응답 메시지가 JSON 형식이 아님(예: 응답 메시지가 HTML 형식임)
• 기타 예외 사항, 오류, 알 수 없는 동작 또는 중단

예약 생성 요청 후에 다음을 포함하는 예약 검색 요청이 뒤따라야 합니다.

• 예약 생성 요청에 사용된 affiliate_reference_id의 기존 값 및 이메일
• 또는 예약 생성 응답에 반환된 itinerary_id 및 links.retrieve.href 값

그런 다음 예약 상태를 검색할 수 있습니다. 단, 새로운 예약의 결과가 나타나기까지 최대 90초가 지연되는 경우도 있습니다.

권장 절차

항상 affiliate_reference_id 전송

각 고객의 예약에 대해 고유한 affiliate_reference_id를 생성합니다. 시도 실패 등으로 인해 같은 요청 세부 정보를 재발송하는 경우 동일한 affiliate_reference_id를 사용해야 합니다. 이렇게 하면 실수로 예약이 중복되는 상황을 방지할 수 있습니다. 새로운 예약 생성 요청을 보내면 API는 예약이 확정되거나 거부될 때까지 응답하지 않습니다. 대부분의 응답은 몇 초 이내로 반환됩니다. 그러나 드물게 응답을 처리하고 생성하는 데 최대 몇 분이 걸리는 예약도 있습니다.

빠르게 해결되지 않는 예약 모니터링

Rapid는 외부 시스템에 연결하여 실시간으로 예약을 진행합니다. 다양한 호텔 예약 시스템, 프런트 데스크 리셉션 시스템, 신용카드 프로세서 또는 사기 감지 시스템이 종속 시스템이 될 수 있으며, 예약의 98%가 최대 13초 이내에 프로세스를 완료할 수 있습니다. 그러나 90초 후에도 예약 응답을 받지 못한 경우 예약과 함께 전송된 동일한 affiliate_reference_id를 사용하여 검색 요청을 통해 예약 진행 상황을 확인해 주세요. 예약이 아직 진행 중이거나 예약에 실패한 경우 "제공된 요청으로 일정을 찾을 수 없습니다." 메시지와 함께 404 오류가 표시됩니다. 이 메시지를 받은 후 동일한 affiliate_reference_id로 예약 요청을 다시 시도해야 합니다. 예약이 계속해서 완료 처리 중인 경우 "이 제휴사 참조 ID를 가진 일정이 이미 존재합니다." 메시지와 함께 400 오류가 표시됩니다. 이 오류가 반환되면 예약을 다시 검색하여 예약 세부 정보가 표시될 준비를 마쳤는지 확인하면 됩니다.

검색 API는 예약이 처리 중일 때 오류 또는 불완전한 응답을 반환할 수 있습니다. 나중에 예약 검색을 다시 시도하면 오류가 99.99% 복구됩니다. 그렇지 않은 경우 Rapid 콜센터 상담원에게 후속 조치를 문의하여 추가적인 지원을 받을 수 있습니다.

예약 이의 제기

시간 초과, 50x HTTP 코드 오류 또는 기타 인프라 문제로 인해 예약에 문제가 발생하는 경우 문제 해결을 위해 다음과 같은 Rapid API 트랜잭션 로그를 제공해 주셔야 합니다.

• 예약 요청 및 응답(가능한 경우)
• 마지막 예약 시도 후 90초 후에 전송된 예약 검색 요청 및 응답

로그에는 요청 및 응답의 HTTP 헤더가 모두 포함되어야 합니다. 응답 메시지에는 Rapid API 트랜잭션을 식별하는 데 도움이 되는 transaction-id 헤더가 있습니다. 이 링크에서 보다 자세한 오류 처리 지침을 확인하실 수 있습니다.

사용자 인터페이스 예, 예약 처리를 위한 의사 코드 및 통합 계획 예를 확인하려면 Rapid 지원 계정에 로그인해 주세요.