Leer la cuadrícula de tarifas

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

La cuadrícula de tarifas de una villa: una entrada por duración con precio.

Una duración ausente de la cuadrícula no se puede reservar en esta villa — ni siquiera a un precio negociado. La cuadrícula dice lo que ofrece la villa.

Los importes son enteros en la unidad menor de la moneda de la organización (ADR 003): 1500000 en IDR son 15 000 rupias, 4500 en EUR son 45,00 €. Nunca dividas entre 100 por tu cuenta sin conocer la moneda.

Autorización

Rol en la organizaciónEste endpoint
ownerPermitido
adminPermitido
memberPermitido

Ejemplo

bash
curl -H "x-api-key: $VILLASLOT_API_KEY" \
  "https://villaslot.app/api/v1/properties/1f0a…/rates"

Respuesta

  • 200 OK — las duraciones con precio.
json
{
  "success": true,
  "data": [
    {"durationMinutes": 60, "amount": 1500000},
    {"durationMinutes": 120, "amount": 2800000}
  ]
}

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.