Remplacer les horaires d’ouverture
PUT /api/v1/properties/{propertyId}/opening-hours
Remplace toute la semaine. C’est un PUT, pas un PATCH : un jour absent du corps devient
fermé. Envoyez chaque jour ouvert, à chaque fois.
Une seule plage continue par jour est prise en charge.
Autorisation
| Rôle dans l’organisation | Cet endpoint |
|---|---|
owner | Autorisé |
admin | Autorisé |
member | Refusé — 403 |
Corps de la requête
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
openingHours | tableau | oui | Un objet par jour ouvert |
openingHours[].dayOfWeek | entier | oui | 0 dimanche … 6 samedi, chaque jour au plus une fois |
openingHours[].openMinute | entier | oui | De 0 à 1440, minutes locales |
openingHours[].closeMinute | entier | oui | Strictement après openMinute |
Exemple
bash
curl -X PUT -H "x-api-key: $VILLASLOT_API_KEY" -H "content-type: application/json" \
-d '{"openingHours":[{"dayOfWeek":1,"openMinute":480,"closeMinute":1200}]}' \
"https://villaslot.app/api/v1/properties/1f0a…/opening-hours"Réponse
200 OK— la semaine enregistrée, relue.
Ce qu’il refuse
403 Forbidden— le porteur de la clé est unmember.422 Unprocessable Entity—openingHoursabsent ou qui n’est pas une liste, une heure de fermeture avant son heure d’ouverture, un jour en double, ou une minute hors de 0–1440.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
- Les réservations existantes ne sont pas touchées. Fermer un jour n’annule pas ce qui y était déjà réservé ; le calendrier l’affiche et l’équipe décide.