Confirmar una reserva
POST /api/v1/bookings/{bookingId}/confirm
Confirma una reserva provisional. No es un cambio de etiqueta: entre la reserva provisional y su confirmación alguien puede haber ocupado la franja, así que la disponibilidad se vuelve a comprobar. La reserva queda excluida de su propia comprobación.
No crea ningún pago ni toca el estado financiero: una reserva confirmada puede estar UNPAID.
Autorización
| Rol en la organización | Este endpoint |
|---|---|
owner | Permitido |
admin | Permitido |
member | Permitido |
Cuerpo de la petición
Ninguno.
Ejemplo
bash
curl -X POST -H "x-api-key: $VILLASLOT_API_KEY" \
"https://villaslot.app/api/v1/bookings/5b2c…/confirm"Respuesta
200 OK— la reserva,status: "CONFIRMED".
Qué rechaza
409 Conflict— la franja se ha ocupado entretanto (OVERLAP), la reserva provisional ha caducado (HOLD_EXPIRED) o su estado ha cambiado mientras tanto (STATUS_CHANGED).detaildice cuál, y los tres piden pasos siguientes distintos: una franja ocupada significa elegir otra, una reserva provisional caducada significa que la franja vuelve a estar libre.422 Unprocessable Entity— la reserva no es provisional.401 Unauthorized— clave ausente o no válida, o clave cuyo portador ha dejado la organización.404 Not Found— identificador desconocido, o identificador que pertenece a otra organización. Los dos son deliberadamente indistinguibles.429 Too Many Requests— más de 120 peticiones en un minuto para esta clave.