예약 요청 처리
예약 요청을 적절히 처리하여 오류와 손실을 방지하세요.
개요
예약 요청 워크플로를 설계할 때는 네트워크 문제에 내성을 갖도록 설계하는 것이 중요합니다. 응답이 없다고 해서 예약이 실패했다는 의미로 해석하지 마세요. 예약 요청이 전송된 후 응답이 수신되기 전에 인프라 문제가 발생하더라도 시스템 내에서 여행자의 예약이 청구 및 확정되었을 수 있습니다. 인프라 문제는 다음과 같을 수 있습니다.
- 네트워크 연결이 끊어졌습니다(응답이 반환되지 않음).
- Server-side 오류(HTTP 코드 500 또는 503)가 반환됩니다.
- 잘못된 네트워크 게이트웨이가 관찰되었습니다(HTTP 코드 502가 반환됨).
- 네트워크 게이트웨이 시간 초과가 관찰됩니다(HTTP 코드 504가 반환됨).
- 응답이 Rapid API 설명서를 따르지 않습니다(메시지에 핵심 요소가 누락됨).
- 응답이 JSON 형식이 아닙니다(예: 응답 메시지가 HTML인 경우).
- 기타 예외 사항, 오류, 알 수 없는 동작 또는 중단
예약 생성 요청 후에 다음을 포함하는 예약 검색 요청이 뒤따라야 합니다.
- 예약 생성 요청에 사용된
affiliate_reference_id의 기존 값 및 이메일 OR - 예약 생성 응답에서 반환된
itinerary_id및links.retrieve.href값입니다.
참고: 새로 생성된 일정 생성 시점과 검색 가능한 시간 사이에 약간의 지연이 있을 수 있습니다. 성공적으로 생성된 일정를 검색할 때 오류가 발생하거나 itinerary_id및 creation_date_time이라는 응답이 모두 표시되는 경우, 30분 동안 검색을 다시 시도한 후 following-up 콜센터 상담원에게 문의하여 추가 지원을 받으시기 바랍니다.
권장 절차
항상 affiliate_reference_id 전송
각 예약에 대해 고유한 affiliate_reference_id을 생성합니다. 동일한 요청 세부 정보를 다시 보내는 경우(예: 실패한 시도로 인해) 동일한 affiliate_reference_id을 사용해야 합니다. 이렇게 하면 실수로 예약이 중복되는 상황을 방지할 수 있습니다. 새로운 예약 생성 요청을 보내면 API는 예약이 확정되거나 거부될 때까지 응답하지 않습니다. 대부분의 응답은 몇 초 이내로 반환됩니다. 그러나 드물게 응답을 처리하고 생성하는 데 최대 몇 분이 걸리는 예약도 있습니다.
빠르게 해결되지 않는 예약 모니터링
Rapid API 에서 외부 시스템으로 연결하여 예약할 수 있습니다. real-time. 종속 시스템에는 호텔 예약 또는 접수 시스템, 신용카드 프로세서 또는 사기 탐지 시스템이 포함됩니다. 예약의 98%는 최대 13초 이내에 프로세스를 완료할 수 있습니다. 그러나 90초 후에도 예약 응답을 받지 못한 경우 예약과 함께 전송된 동일한 affiliate_reference_id를 사용하여 검색 요청을 통해 예약 진행 상황을 확인해 주세요. 예약이 아직 진행 중이거나 예약에 실패한 경우 "제공된 요청으로 일정을 찾을 수 없습니다." 메시지와 함께 404 오류가 표시됩니다. 이 메시지를 받은 후 동일한 affiliate_reference_id로 예약 요청을 다시 시도해야 합니다. 예약이 계속해서 완료 처리 중인 경우 "이 제휴사 참조 ID를 가진 일정이 이미 존재합니다." 메시지와 함께 400 오류가 표시됩니다. 이 오류가 반환되면 예약을 다시 검색하여 예약 세부 정보가 표시될 준비를 마쳤는지 확인하면 됩니다.
검색 API는 예약이 처리 중일 때 오류 또는 불완전한 응답을 반환할 수 있습니다. 나중에 예약 검색을 다시 시도하면 오류가 99.99% 복구됩니다. 성능 저하 시나리오를 해결하려면 30분 동안 검색을 다시 시도한 후 추가 지원을 요청하세요.
예약 이의 제기
시간 초과, 50배수 HTTP 코드 오류 또는 기타 인프라 문제로 인해 예약에 문제가 발생하는 경우, 문제 해결을 위해 다음 거래 로그를 제공해 주세요:
- 예약 요청 및 응답(가능한 경우)
- 마지막 예약 시도 후 30분 후에 전송된 예약 조회 요청 및 응답입니다.
로그에는 요청 및 응답의 HTTP 헤더가 모두 포함되어야 합니다. 응답 메시지에는 Rapid API 트랜잭션을 식별하는 데 도움이 되는 transaction-id 헤더가 있습니다.
Rapid API 지원 계정에 로그인하여 사용자 인터페이스 예제, 예약 처리를 위한 의사 코드, 통합 플랜 예제 를 확인하세요.