Modifier les réglages de réservation | VillaSlot Documentation

PATCH /api/v1/settings/booking

Modifie les règles de réservation. Les champs absents du corps gardent leur valeur actuelle.

Autorisation

Rôle dans l’organisation	Cet endpoint
`owner`	Autorisé
`admin`	Autorisé
`member`	Refusé — `403`

Les réglages suivent le droit de modifier l’organisation elle-même.

Corps de la requête

Champ	Type	Description
`currency`	enum	`IDR`, `EUR` ou `USD`
`timezone`	enum	`UTC`, `Asia/Makassar`, `Asia/Jakarta`, `Asia/Singapore`, `Asia/Dubai`, `Europe/Paris`, `Europe/London`, `America/New_York`
`bufferMinutes`	entier	De 0 à 480, l’écart gardé entre deux shootings
`holdExpirationHours`	entier	De 1 à 720
`holdBlocksSlot`	booléen	Si une option occupe le créneau
`publicBookingEnabled`	booléen	Ouvre la page de réservation publique
`minimumNights`	entier	De 1 à 30, pour les nuitées
`turnoverGuardEnabled`	booléen	Protège la plage check-out / check-in
`turnoverGuardMinimumMinutes`	entier	Durée minimale d’un shooting qui empiète sur la plage : 60 à 480, par heure entière (60, 120… 480)

Exemple

bash

curl -X PATCH -H "x-api-key: $VILLASLOT_API_KEY" -H "content-type: application/json" \
  -d '{"bufferMinutes":45}' \
  "https://villaslot.app/api/v1/settings/booking"

Réponse

200 OK — les réglages enregistrés.

Ce qu’il refuse

403 Forbidden — le porteur de la clé est un member.
422 Unprocessable Entity — une devise ou un fuseau horaire non pris en charge, ou une valeur hors de sa plage.
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é.

Notes

Changer le fuseau horaire change la façon dont les futures paires date / startMinute sont lues. Cela ne déplace pas une seule réservation existante : celles-ci sont stockées sous forme d’instants.
Changer le battement ne s’applique qu’aux réservations futures ; chaque réservation garde le battement figé sur sa ligne.

Règles de conflit Airbnb

airbnbReservedPolicy accepte warn (par défaut) ou block. Indépendamment, airbnbUnavailablePolicy accepte ignore, warn (par défaut) ou block. Les champs omis conservent les règles enregistrées, y compris pour les requêtes de clients plus anciens. Les permissions OWNER/ADMIN s’appliquent.