Reemplazar el horario de apertura
PUT /api/v1/properties/{propertyId}/opening-hours
Reemplaza toda la semana. Es un PUT, no un PATCH: un día ausente del cuerpo pasa a estar
cerrado. Envía todos los días abiertos, cada vez.
Solo se admite una franja continua por día.
Autorización
| Rol en la organización | Este endpoint |
|---|---|
owner | Permitido |
admin | Permitido |
member | Rechazado — 403 |
Cuerpo de la petición
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
openingHours | array | sí | Un objeto por día abierto |
openingHours[].dayOfWeek | entero | sí | 0 domingo … 6 sábado, cada día como máximo una vez |
openingHours[].openMinute | entero | sí | De 0 a 1440, minutos locales |
openingHours[].closeMinute | entero | sí | Estrictamente posterior a openMinute |
Ejemplo
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"Respuesta
200 OK— la semana guardada, releída.
Qué rechaza
403 Forbidden— el portador de la clave es unmember.422 Unprocessable Entity—openingHoursausente o que no es una lista, una hora de cierre anterior a su hora de apertura, un día duplicado o un minuto fuera de 0–1440.401 Unauthorized— clave ausente o no válida, o clave cuyo portador ha dejado la organización.404 Not Found— identificador desconocido, o identificador que pertenece a otra organización. Los dos son deliberadamente indistinguibles.429 Too Many Requests— más de 120 peticiones en un minuto para esta clave.
Notas
- Las reservas existentes no se tocan. Cerrar un día no cancela lo que ya estaba reservado en él; el calendario lo muestra y el equipo decide.