Primeros pasos
De una organización vacía a una reserva confirmada, en el orden que espera el producto. Cinco pasos, y el equivalente API de cada uno.
1. Crear una villa
Villas → Añadir una villa. Un nombre y una foto bastan para crearla; todo lo que importa viene después.
Una villa necesita su horario de apertura y sus tarifas antes de poder aceptar una reserva. Una villa que parece lista pero rechaza todas las franjas casi siempre carece de uno de los dos.
2. Darle un horario de apertura
Villa → Horarios de apertura. Una cuadrícula semanal: para cada día, cuándo abre la villa y cuándo cierra. Un día dejado vacío es un día cerrado.
Las reservas se comprueban contra esta cuadrícula, así que decide más de lo que parece: una villa abierta de 09:00 a 18:00 rechazará una franja a las 08:30, y el calendario sombrea las bandas cerradas para que nadie lo intente.
API: PUT /api/v1/properties/{id}/opening-hours
3. Darle tarifas
Villa → Tarifas de sesión de fotos. Un precio por duración. La cuadrícula es lo que la villa ofrece: una duración ausente de ella no se puede reservar en absoluto, ni siquiera a un precio negociado. Puedes cambiar el importe de una reserva concreta, pero la duración tiene que existir antes en la cuadrícula.
API: PUT /api/v1/properties/{id}/rates
4. Añadir un cliente
Clientes → Nuevo cliente. Solo el nombre es obligatorio. Un email te permite enviarle un enlace de pago, y un enlace de acceso a su propio espacio.
API: POST /api/v1/customers — o
POST /api/v1/customers/bulk para importar una lista en
una sola llamada.
5. Reservar una franja
Calendario. Arrastra sobre las horas que quieres, el día que quieres: la villa, la franja y el precio se rellenan solos. Elige el cliente y confirma.
La reserva se rechaza si la franja cae fuera del horario de la villa, si su duración no está en la cuadrícula de tarifas, o si una reserva confirmada ya se solapa con ella.
Obtener una clave API
Cuenta → Claves API → Crear clave API. Una clave pertenece a una sola organización y lleva tus propios derechos en ella. Cópiala cuando se muestra — no se vuelve a mostrar.
curl -H "x-api-key: $VILLASLOT_API_KEY" \
"https://villaslot.app/api/v1/me"Esa primera llamada convierte una simple clave en un contexto: qué organización abre, qué rol lleva, la zona horaria y la moneda de las que dependen todas las demás llamadas, y cuánto espacio te deja tu plan.
Todo lo anterior tiene un equivalente HTTP, y una página que lo detalla. El mapa completo está en API.