CreateBooking Ready

Aby ukończyć zadanie „CreateBooking” Ready, musisz pomyślnie utworzyć i dostarczyć metodę CreateBooking.CreateBooking 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 żądań CreateBooking w piaskownicy ze wskaźnikiem sukcesu na poziomie co najmniej 90%.
  • 3 żądania CreateBooking w środowisku produkcyjnym ze wskaźnikiem sukcesu na poziomie co najmniej 90%.

Podstawowe informacje o CreateBooking

Gdy użytkownik rozpocznie rezerwację, do serwera rezerwacji partnera zostanie wysłane żądanie CreateBooking. Odpowiedź na żądanie wskazuje, czy rezerwacja została utworzona, czy nie. Jeśli rezerwacja nie zostanie utworzona, odpowiedź musi zawierać błąd logiki biznesowej. Na przykład termin stał się niedostępny lub został już zarezerwowany przez tego samego użytkownika.

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

Idempotentność

Komunikacja w sieci nie zawsze jest niezawodna, a 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. Dzięki temu możesz odróżnić ponowione wywołanie REST, które ma na celu utworzenie jednego żądania, od 2 oddzielnych żądań. Odpowiednie identyfikatory wpisów rezerwacji UpdateBooking pomagają je jednoznacznie zidentyfikować, dlatego w ich żądaniach nie jest uwzględniany token idempotentności.

Oto kilka przykładów obsługi idempotentności przez serwery rezerwacji:

  • Odpowiedź HTTP informująca o powodzeniu CreateBooking zawiera utworzoną rezerwację. W niektórych przypadkach płatność jest przetwarzana w ramach procesu rezerwacji. Jeśli to samo żądanie CreateBookingRequest zostanie odebrane po raz drugi z tym samym tokenem idempotency_token, należy zwrócić tę samą odpowiedź CreateBookingResponse. Druga rezerwacja nie zostanie utworzona, a użytkownik zostanie obciążony tylko raz, jeśli ma to zastosowanie.

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