Um die Aufgabe für den Meilenstein „CreateBooking bereit“ abzuschließen, müssen Sie die Methode CreateBooking erfolgreich erstellen und bereitstellen. Diese Methode wird aufgerufen, wenn ein Nutzer versucht, eine Buchung zu erstellen. Wenn eine Buchung erfolgreich erstellt wurde, enthält die Antwort eine eindeutige booking_id, mit der Sie in zukünftigen Anfragen oder Aktualisierungen auf die Buchung verweisen können.
Anforderungen für die Aufgabe „CreateBooking“
- 10
CreateBooking-Anfragen in der Sandbox mit einer Erfolgsquote von mindestens 90 % - 3
CreateBooking-Anfragen in der Produktion mit einer Erfolgsquote von mindestens 90 %
Grundlagen zu „CreateBooking“
Wenn ein Nutzer eine Buchung initiiert, wird eine CreateBooking-Anfrage an den Buchungsserver des Partners gesendet. Die Antwort auf die Anfrage gibt an, ob die Buchung erfolgreich war oder fehlgeschlagen ist. Wenn die Buchung fehlgeschlagen ist, muss die Antwort den Fehler in der Geschäftslogik enthalten. Beispielsweise ist der Slot nicht mehr verfügbar oder wurde bereits vom selben Nutzer gebucht.
Wenn ein Nutzer eine Buchung erstellt, sendet Google Ihnen den Namen, den Nachnamen, die Telefonnummer und die E-Mail-Adresse des Nutzers. Weitere Informationen finden Sie in der Richtlinie zur Kontenabstimmung und -erstellung. Account matching and creation policy.
Idempotenz
Die Kommunikation über das Netzwerk ist nicht immer zuverlässig. Daher sendet Google HTTP-Anfragen eventuell noch einmal, wenn keine Antwort zurückgegeben wird. Aus diesem Grund müssen alle Methoden, die den Status ändern, idempotent sein:
CreateBookingUpdateBooking
Für jede Anfragenachricht außer UpdateBooking werden Idempotenz-Token verwendet, um die Anfrage eindeutig zu identifizieren. Dadurch können Sie zwischen einem REST-Aufruf, der noch einmal gesendet wurde und über den eine einzelne Anfrage erstellt werden soll, und zwei separaten Anfragen unterscheiden. Die entsprechenden Buchungseintrags-IDs von UpdateBooking helfen dabei, sie eindeutig zu identifizieren. Daher ist in diesen Anfragen kein Idempotenz-Token enthalten.
Nachfolgend finden Sie einige Beispiele dafür, wie Buchungsserver Idempotenz verarbeiten:
Eine erfolgreiche
CreateBookingHTTP-Antwort enthält die erstellte Buchung. In einigen Fällen wird die Zahlung im Rahmen des Buchungsablaufs verarbeitet. Wenn dieselbeCreateBookingRequestmit demselbenidempotency_tokenein zweites Mal eingeht, muss auch dieselbeCreateBookingResponsezurückgegeben werden. Es wird keine zweite Buchung erstellt und der Nutzer muss genau einmal bezahlen.
Die Idempotenz-Vorgabe gilt für alle Methoden, die den Status ändern.