Renommer une villa
PATCH /api/v1/properties/{propertyId}
Renomme une villa. Rien d’autre ne bouge : la photo, l’état d’archivage et le tarif de nuit sont des gestes séparés, à dessein — renommer ne doit pas effacer une photo en silence.
Autorisation
| Rôle dans l’organisation | Cet endpoint |
|---|---|
owner | Autorisé |
admin | Autorisé |
member | Refusé — 403 |
Corps de la requête
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
name | chaîne | oui | De 1 à 120 caractères |
Exemple
bash
curl -X PATCH -H "x-api-key: $VILLASLOT_API_KEY" -H "content-type: application/json" \
-d '{"name":"Villa Suar — Beachfront"}' \
"https://villaslot.app/api/v1/properties/1f0a…"Réponse
200 OK— la villa mise à jour.
Ce qu’il refuse
403 Forbidden— le porteur de la clé est unmember.422 Unprocessable Entity— le nom est absent ou trop long.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é.