Confirmer une réservation
POST /api/v1/bookings/{bookingId}/confirm
Confirme une option. Ce n’est pas un changement d’étiquette : entre l’option et sa confirmation, quelqu’un a pu prendre le créneau, la disponibilité est donc revérifiée. La réservation est exclue de sa propre vérification.
Ne crée aucun paiement et ne touche pas au statut financier : une réservation confirmée peut être UNPAID.
Autorisation
| Rôle dans l’organisation | Cet endpoint |
|---|---|
owner | Autorisé |
admin | Autorisé |
member | Autorisé |
Corps de la requête
Aucun.
Exemple
bash
curl -X POST -H "x-api-key: $VILLASLOT_API_KEY" \
"https://villaslot.app/api/v1/bookings/5b2c…/confirm"Réponse
200 OK— la réservation,status: "CONFIRMED".
Ce qu’il refuse
409 Conflict— le créneau a été pris entre-temps (OVERLAP), l’option a expiré (HOLD_EXPIRED) ou son statut a changé dans votre dos (STATUS_CHANGED).detaildit lequel, et les trois appellent des suites différentes : un créneau pris veut dire en choisir un autre, une option expirée veut dire que le créneau est de nouveau libre.422 Unprocessable Entity— la réservation n’est pas une option.401 Unauthorized— clé absente ou invalide, ou clé dont le porteur a quitté l’organisation.404 Not Found— identifiant inconnu, ou identifiant appartenant à une autre organisation. Les deux sont volontairement indiscernables.429 Too Many Requests— plus de 120 requêtes en une minute pour cette clé.