CreateBooking 준비 완료

CreateBooking 준비 완료 마일스톤 작업을 완료하려면 CreateBooking 메서드를 성공적으로 빌드하고 제공해야 합니다. 이 메서드는 사용자가 예약을 생성하려고 할 때 호출됩니다. 예약이 성공적으로 생성되면 응답에 고유한 booking_id가 포함되어 향후 요청 또는 업데이트를 위해 예약을 참조할 수 있습니다.

CreateBooking 작업 요구사항

  • 샌드박스에서 성공률이 90% 이상인 CreateBooking 요청 10개
  • 프로덕션에서 성공률이 90% 이상인 CreateBooking 요청 3개

CreateBooking 기본사항

사용자가 예약을 시작하면 CreateBooking 요청이 파트너 예약 서버로 전송됩니다. 요청에 대한 응답은 예약 성공 또는 예약 실패를 나타냅니다. 예약이 실패하면 응답에 실패에 대한 비즈니스 로직 오류가 포함되어야 합니다. 예를 들어 시간대가 예약 불가능하게 되었거나 동일한 사용자가 시간대를 이미 예약한 경우입니다.

사용자가 예약을 만들면 Google에서 사용자의 이름, 성, 전화번호, 이메일을 전송합니다. 자세한 내용은 계정 일치 및 생성 정책을 참고하세요.

멱등성

네트워크를 통한 통신이 항상 신뢰할 수 있는 것은 아니며 응답을 받지 못하면 Google에서 HTTP 요청을 다시 시도할 수 있습니다. 따라서 상태를 변경하는 모든 메서드는 멱등성을 갖춰야 합니다.

  • CreateBooking
  • UpdateBooking

UpdateBooking을 제외한 모든 요청 메시지에 멱등성 토큰이 포함되어 요청을 고유하게 식별합니다. 이렇게 하면 단일 요청을 만드는 인텐트와 두 개의 개별 요청을 사용하여 재시도된 REST 호출을 구분할 수 있습니다. UpdateBooking의 각 예약 항목 ID는 이를 고유하게 식별하는 데 도움이 되므로 요청에 멱등성 토큰이 포함되지 않습니다.

다음은 예약 서버가 멱등성을 처리하는 방법의 몇 가지 예입니다.

  • 성공한 CreateBooking HTTP 응답에는 생성된 예약이 포함됩니다. 경우에 따라 결제가 예약 과정의 일부로 처리됩니다. 동일한 idempotency_token으로 동일한 CreateBookingRequest가 두 번째로 수신되면 동일한 CreateBookingResponse가 반환되어야 합니다. 두 번째 예약이 생성되지 않으며 해당하는 경우 사용자에게 정확히 한 번만 청구됩니다.

멱등성 요구사항은 상태를 변경하는 모든 메서드에 적용됩니다.