Lire une villa
GET /api/v1/properties/{propertyId}
Une villa, archivées comprises : l’historique de ses réservations doit rester lisible après sa sortie du catalogue.
Autorisation
| Rôle dans l’organisation | Cet endpoint |
|---|---|
owner | Autorisé |
admin | Autorisé |
member | Autorisé |
Paramètres de chemin
| Paramètre | Type | Description |
|---|---|---|
propertyId | uuid | L’identifiant de la villa |
Exemple
bash
curl -H "x-api-key: $VILLASLOT_API_KEY" \
"https://villaslot.app/api/v1/properties/1f0a…"Réponse
200 OK— la villa, aveccheckInMinuteetcheckOutMinute(entiers de 0 à 1439, minutes locales dans le fuseau horaire de l’organisation). Valeurs par défaut : 840 / 720 (14:00 / 12:00). Modifier les réglages de la villa ne change jamais les instants enregistrés des réservations.
Ce qu’il refuse
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é.