Leer una villa
GET /api/v1/properties/{propertyId}
Una villa, incluidas las archivadas: el historial de sus reservas debe seguir siendo legible después de que salga del catálogo.
Autorización
| Rol en la organización | Este endpoint |
|---|---|
owner | Permitido |
admin | Permitido |
member | Permitido |
Parámetros de ruta
| Parámetro | Tipo | Descripción |
|---|---|---|
propertyId | uuid | El identificador de la villa |
Ejemplo
bash
curl -H "x-api-key: $VILLASLOT_API_KEY" \
"https://villaslot.app/api/v1/properties/1f0a…"Respuesta
200 OK— la villa, incluidoscheckInMinuteycheckOutMinute(enteros de 0 a 1439, minutos locales en la zona horaria de la organización). Por defecto: 840 / 720 (14:00 / 12:00). Cambiar los ajustes de la villa nunca cambia los instantes guardados de las reservas.
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.