Клиент использует UpdateBooking для изменения или отмены существующего бронирования.
Если обновление бронирования не удается из-за какой-либо ошибки бизнес-логики, ошибка должна быть заполнена в поле UpdateBookingResponse.booking_failure и возвращена со статусом HTTP 200.
Запрос
ОбновлениеЗапрос на бронирование
Сообщение запроса содержит обновленную информацию в поле бронирования. Запрос будет содержать booking_id для идентификации бронирования, которое необходимо обновить. Он также будет включать в себя одно из:
- Сведения о слоте для обновления (изменения бронирования)
- Статус для изменения (отмена бронирования)
Поля, не требующие изменения, в запросе предоставляться не будут.
Возвращаемое значение
ОбновлениеBookingResponse
// 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"
}
}
Образцы UpdateBooking для фитнеса
{
"booking" : {
"booking_id" : "890",
"status" : "CANCELED"
}
}
{
"booking" : {
"booking_id" : "890",
"status" : "CANCELED"
}
}
Образцы UpdateBooking для финансовых услуг
TODO