Annuler une réservation
POST /api/v1/bookings/{bookingId}/cancel
Annule une réservation. Le créneau est libéré, l’argent ne bouge pas : aucune ligne de paiement n’est supprimée, aucun total payé n’est recalculé, aucun statut financier n’est réécrit. Un remboursement est une opération distincte.
Autorisation
| Rôle dans l’organisation | Cet endpoint |
|---|---|
owner | Autorisé |
admin | Autorisé |
member | Autorisé |
Exemple
bash
curl -X POST -H "x-api-key: $VILLASLOT_API_KEY" \
"https://villaslot.app/api/v1/bookings/5b2c…/cancel"Réponse
200 OK— la réservation,status: "CANCELLED".
Ce qu’il refuse
422 Unprocessable Entity— la réservation est déjà annulée, terminée ou expiré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é.
Irréversible. Une réservation annulée ne se rouvre pas ; le client doit être réservé de nouveau. Un agent n’annule pas sans un feu vert humain explicite pour cette réservation précise.