CreateBooking Ready

Aby ukończyć zadanie CreateBookingGotoweCreateBooking, musisz utworzyć i dostarczyć CreateBooking metodę. Ta metoda jest wywoływana, gdy użytkownik próbuje utworzyć rezerwację. Jeśli rezerwacja zostanie utworzona, odpowiedź będzie zawierać unikalny identyfikator booking_id, który będzie można wykorzystać w przyszłych żądaniach lub aktualizacjach.

Wymagania dotyczące zadania CreateBooking

  • 10 odpowiedzi CreateBooking z odsetkiem błędów mniejszym niż 10%.

Podstawowe informacje o CreateBooking

Gdy użytkownik rozpoczyna rezerwację, do serwera rezerwacji partnera wysyłane jest żądanie CreateBooking. Odpowiedź na prośbę wskazuje, czy rezerwacja została dokonana, czy nie. Jeśli rezerwacja się nie powiedzie, odpowiedź musi zawierać błąd logiki biznesowej. Na przykład miejsce stało się niedostępne lub zostało już zarezerwowane przez tego samego użytkownika.

Gdy użytkownik utworzy rezerwację, Google wyśle Ci jego imię, nazwisko, numer telefonu i adres e-mail. Więcej informacji znajdziesz w zasadach dotyczących dopasowywania i tworzenia kont.

nie odzwierciedla dokładnie stanu asortymentu w czasie rzeczywistym.

Idempotentność

Komunikacja w sieci nie zawsze jest niezawodna, dlatego Google może ponawiać żądania HTTP, jeśli nie otrzyma odpowiedzi. Z tego powodu wszystkie metody, które zmieniają stan, muszą być idempotentne:

  • CreateBooking
  • UpdateBooking

W przypadku każdej wiadomości z żądaniem, z wyjątkiem UpdateBooking, tokeny idempotentności są dołączane w celu jednoznacznego zidentyfikowania żądania. Pozwala to odróżnić ponowione wywołanie REST, które ma na celu utworzenie pojedynczego żądania, od 2 osobnych żądań. Odpowiednie identyfikatory wpisów rezerwacji UpdateBooking pomagają w ich jednoznacznym identyfikowaniu, więc w ich żądaniach nie ma tokena idempotentności.

Oto kilka przykładów, jak serwery rezerwacji obsługują idempotentność:

  • Odpowiedź HTTP CreateBooking informująca o powodzeniu zawiera utworzoną rezerwację. W niektórych przypadkach płatność jest przetwarzana w ramach procesu rezerwacji. Jeśli ten sam CreateBookingRequest zostanie odebrany po raz drugi z tym samym idempotency_token, musi zostać zwrócony ten sam CreateBookingResponse. Nie zostanie utworzona druga rezerwacja, a użytkownik zostanie obciążony opłatą tylko raz (w stosownych przypadkach).

Wymóg idempotentności dotyczy wszystkich metod, które zmieniają stan.