Reemplazar la cuadrícula de tarifas

PUT /api/v1/properties/{propertyId}/rates

Reemplaza toda la cuadrícula. Una duración ausente del cuerpo pierde su tarifa y desaparece de las opciones de reserva de esta villa.

Las cinco duraciones que admite el producto son 60, 120, 180, 300 y 480 minutos. La lista es cerrada: no se puede añadir ni renombrar ninguna duración.

Autorización

Rol en la organizaciónEste endpoint
ownerPermitido
adminPermitido
memberRechazado — 403

Cuerpo de la petición

CampoTipoObligatorioDescripción
ratesarraysíUn objeto por duración con precio
rates[].durationMinutesenterosíUna de 60, 120, 180, 300, 480
rates[].amountenterosíEstrictamente positivo, unidad menor de la moneda

Ejemplo

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"

Respuesta

  • 200 OK — la cuadrícula guardada, releída.

Qué rechaza

  • 403 Forbidden — el portador de la clave es un member.
  • 422 Unprocessable Entity — rates ausente o que no es una lista, una duración no admitida, una duración duplicada o un importe que no es un entero positivo.
  • 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.

Notas

  • Ninguna reserva existente cambia de precio. El importe se copia en la reserva al crearla, y nunca se vuelve a leer de la cuadrícula.