Um die Aufgabe für den CreateBooking-Meilenstein abzuschließen, müssen Sie die CreateBooking-Methode erfolgreich entwickeln und bereitstellen. Diese Methode wird aufgerufen, wenn ein Nutzer versucht, eine Buchung zu erstellen. Wenn eine erfolgreiche Buchung erstellt wird, enthält die Antwort eine eindeutige booking_id, mit der auf die Buchung in zukünftigen Anfragen oder Updates verwiesen werden kann.
Anforderungen an die Aufgabe „CreateBooking“
- 10 erfolgreiche
CreateBooking-Antworten mit einer Fehlerrate von weniger als 10%.
CreateBooking – Grundlagen
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 ein Buchungsfehler auftritt, muss die Antwort den Fehler in der Geschäftslogik für den Fehler enthalten. Das kann z. B. passieren, wenn der Slot nicht mehr verfügbar ist oder bereits vom selben Nutzer gebucht wurde.
Wenn ein Nutzer eine Buchung erstellt, sendet Google dir den Namen, den Nachnamen, die Telefonnummer und die E-Mail-Adresse, die er angegeben hat. Weitere Informationen finden Sie unter Richtlinie zum Kontoabgleich und zur Kontoerstellung.
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-Tokens 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 IDs für die Buchungseinträge von UpdateBooking helfen dabei, sie eindeutig zu identifizieren. Daher ist in diesen Anfragen kein Idempotenz-Token enthalten.
Nachfolgend findest du einige Beispiele dafür, wie Buchungsserver Idempotenz verarbeiten:
Eine erfolgreiche HTTP-Antwort auf
CreateBookingenthält die erstellte Buchung. In einigen Fällen wird die Zahlung im Rahmen des Buchungsablaufs verarbeitet. Wenn dieselbeCreateBookingRequest-Anfrage ein zweites Mal mit demselbenidempotency_tokeneingeht, muss auch dieselbeCreateBookingResponse-Antwort zurü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.