Terminer une réservation

POST /api/v1/bookings/{bookingId}/complete

Marque une réservation confirmée comme terminée. Manuel et rien d’autre : aucune planification ne marque une réservation terminée d’elle-même, et une réservation passée laissée en CONFIRMED n’est pas signalée.

Ne touche ni au prix, ni aux paiements, ni au statut financier.

Autorisation

Rôle dans l’organisationCet endpoint
ownerAutorisé
adminAutorisé
memberAutorisé

Exemple

bash
curl -X POST -H "x-api-key: $VILLASLOT_API_KEY" \
  "https://villaslot.app/api/v1/bookings/5b2c…/complete"

Réponse

  • 200 OK — la réservation, status: "COMPLETED".

Ce qu’il refuse

  • 409 Conflict — le statut a changé dans votre dos.
  • 422 Unprocessable Entity — la réservation n’était pas CONFIRMED : une option, une réservation annulée ou expirée ne peut pas être terminée.
  • 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é.