CreateBooking Ready

Para completar la tarea del hito CreateBooking Listo, debes compilar y entregar correctamente el método CreateBooking. Se llama a este método cuando un usuario intenta crear una reserva. Si se crea una reserva exitosa, la respuesta incluye un booking_id único para hacer referencia a la reserva en solicitudes o actualizaciones futuras.

Requisitos de la tarea CreateBooking

  • 10 respuestas CreateBooking correctas con una tasa de error inferior al 10%

Conceptos básicos de CreateBooking

Cuando un usuario inicia una reserva, se envía una solicitud CreateBooking al servidor de reservas del socio. La respuesta a la solicitud indica si la reserva se realizó correctamente o si hubo un error. Si hay una falla en la reserva, la respuesta debe incluir el error de lógica empresarial correspondiente. Por ejemplo, el espacio dejó de estar disponible o el mismo usuario ya lo reservó.

Cuando un usuario crea una reserva, Google te envía su nombre, apellido, número de teléfono y correo electrónico. Para obtener más información, consulta la Política de creación y vinculación de cuentas.

Idempotencia

La comunicación a través de la red no siempre es confiable, y Google puede reintentar las solicitudes HTTP si no se recibe ninguna respuesta. Por este motivo, todos los métodos que mutan el estado deben ser idempotentes:

  • CreateBooking
  • UpdateBooking

Para todos los mensajes de solicitud, excepto UpdateBooking, se incluyen tokens de idempotencia a fin de identificar exclusivamente la solicitud. Esto te permite distinguir entre una llamada de REST que se reintentó, con la intención de crear una sola solicitud, y dos solicitudes separadas. Los respectivos IDs de entrada de reserva de los UpdateBooking ayudan a identificarlos de forma única, por lo que no se incluye ningún token de idempotencia en sus solicitudes.

Los siguientes son algunos ejemplos de cómo manejan la idempotencia los servidores de reservas:

  • Una respuesta HTTP correcta a CreateBooking debe incluir la reserva creada. En algunos casos, el pago se procesa como parte del flujo de reserva. Si se recibe la misma solicitud CreateBookingRequest por segunda vez con el mismo idempotency_token, se debe mostrar la misma respuesta CreateBookingResponse. No se crea una segunda reserva y se le cobra al usuario exactamente una vez, si corresponde.

El requisito de idempotencia se aplica a todos los métodos que mutan el estado.