הלקוח משתמש ב-UpdateBooking כדי לשנות או לבטל הזמנה קיימת.
אם עדכון הזמנה נכשל בגלל שגיאת לוגיקה עסקית, השגיאה
צריך להיות מאוכלסת בשדה UpdateBookingResponse.booking_failure
ולהחזיר
את ההזמנה עם סטטוס HTTP 200.
שליחת בקשה
UpdateBookingRequest
הודעת בקשה מכילה מידע מעודכן בשדה ההזמנה.
הבקשה תכיל booking_id
לזיהוי ההזמנה לעדכון. התוכנית
תכלול גם את אחת מהאפשרויות הבאות:
- הפרטים של יחידת הקיבולת (Slot) לעדכון (שינויים בהזמנה)
- סטטוס השינוי (ביטול ההזמנה)
שדות שלא מחייבים שינוי לא יופיעו בבקשה.
הערך המוחזר
UpdateBookingResponse
// Request to update a Booking. message UpdateBookingRequest { // The booking to be updated // The following fields can be set in a booking: // - status, to cancel a booking. // - one of the following is required: // - start_time AND duration in the slot, to reschedule a booking. // - party_size (for dining reservations). Booking booking = 1; } // Response with the updated Booking. message UpdateBookingResponse { // The updated booking (required) Booking booking = 1; // The updated user payment option originally used to pay for this booking. // This should be set if the UpdateBookingRequest results in a change to // the UserPaymentOption. // For instance, if the booking is canceled, the UserPaymentOption should // reflect an additional credit to the user. In the case of a multi-use // payment option, the current_count should be increased by one to // allow the user to create another booking with this payment option. In the // case of a single-use payment option, a new single-use user payment option // should be returned. (required if altered in update) UserPaymentOption user_payment_option = 2; // If updating a booking fails, this field should reflect the business logic // error (e.g., booking is not cancellable) (required if failure occurs) BookingFailure booking_failure = 3; }
עדכון דוגמאות להזמנות
עדכון הזמנה של דוגמאות טיפוח
בקשה
{ "booking" : { "booking_id" : "890", "status" : "CANCELED" } }
תשובה
{ "booking" : { "booking_id" : "890", "status" : "CANCELED" } }
עדכון הזמנה לדוגמה של דוגמאות כושר
בקשה
{ "booking" : { "booking_id" : "890", "status" : "CANCELED" } }
תשובה
{ "booking" : { "booking_id" : "890", "status" : "CANCELED" } }
דוגמאות ל-UpdateBooking של שירותים פיננסיים
לביצוע