Remplacer la grille tarifaire
PUT /api/v1/properties/{propertyId}/rates
Remplace toute la grille. Une durée absente du corps perd son tarif et disparaît des choix de réservation pour cette villa.
Les cinq durées que le produit prend en charge sont 60, 120, 180, 300 et 480 minutes. La liste
est fermée : aucune durée ne peut être ajoutée ni renommée.
Autorisation
| Rôle dans l’organisation | Cet endpoint |
|---|---|
owner | Autorisé |
admin | Autorisé |
member | Refusé — 403 |
Corps de la requête
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
rates | tableau | oui | Un objet par durée tarifée |
rates[].durationMinutes | entier | oui | L’une de 60, 120, 180, 300, 480 |
rates[].amount | entier | oui | Strictement positif, dans l’unité mineure de la devise |
Exemple
bash
curl -X PUT -H "x-api-key: $VILLASLOT_API_KEY" -H "content-type: application/json" \
-d '{"rates":[{"durationMinutes":120,"amount":2800000}]}' \
"https://villaslot.app/api/v1/properties/1f0a…/rates"Réponse
200 OK— la grille enregistrée, relue.
Ce qu’il refuse
403 Forbidden— le porteur de la clé est unmember.422 Unprocessable Entity—ratesabsent ou qui n’est pas une liste, une durée non prise en charge, une durée en double, ou un montant qui n’est pas un entier positif.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é.
Notes
- Aucune réservation existante ne change de prix. Le montant est copié sur la réservation à sa création, et n’est jamais relu depuis la grille.