Leer el horario de apertura

GET /api/v1/properties/{propertyId}/opening-hours

El horario de apertura semanal de una villa: una entrada por día abierto.

Un día que falta en la lista está cerrado — que no es lo mismo que libre. La disponibilidad no devolverá ninguna franja para él, y un intento de reserva se rechaza con CLOSED.

Autorización

Rol en la organizaciónEste endpoint
ownerPermitido
adminPermitido
memberPermitido

Unidades

  • dayOfWeek sigue Date#getDay(): 0 domingo … 6 sábado.
  • openMinute y closeMinute cuentan los minutos desde la medianoche local en la zona horaria de la organización, nunca UTC. 480 son las 08:00, 1200 las 20:00.

Ejemplo

bash
curl -H "x-api-key: $VILLASLOT_API_KEY" \
  "https://villaslot.app/api/v1/properties/1f0a…/opening-hours"

Respuesta

  • 200 OK — los días abiertos.
json
{
  "success": true,
  "data": [
    {"dayOfWeek": 1, "openMinute": 480, "closeMinute": 1200},
    {"dayOfWeek": 2, "openMinute": 480, "closeMinute": 1200}
  ]
}

Qué rechaza

  • 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.