Introducción
VillaSlot reserva villas por franjas. Una villa tiene un horario de apertura y una cuadrícula de tarifas; un cliente reserva una hora, una mañana o un día; la reserva se confirma, se paga, se completa — o se cancela.
Ese es todo el producto, y todo lo que hace es accesible por HTTP.
Las cinco cosas que VillaSlot conoce
Organización
Tu equipo y tus villas. Todo lo que sigue pertenece a una sola organización, y nada pasa de una a otra. Tu plan limita cuántas villas, reservas y clientes contiene.
Villa
Un lugar que alquilas por franjas. Lleva su horario de apertura — una cuadrícula semanal, día por día — y su cuadrícula de tarifas, que pone precio a una duración. Fuera de su horario, no se puede reservar nada.
Cliente
Quien reserva. Un nombre, una forma de contactarlo y su historial. A un cliente se le puede dar un enlace de acceso: lo conecta a su propio espacio, donde ve sus reservas y su saldo, y nada más.
Reserva
Una villa, un cliente, una franja. Pasa por estados — pendiente, confirmada, completada, cancelada — y puede llevar un pago.
Pago
Una reserva puede pagarse por completo, en parte o nada. Un enlace de pago va al cliente; Stripe responde y la reserva lo refleja.
Dos puertas de entrada
La interfaz — el calendario, las páginas de las villas, la lista de clientes. Pensada para la persona que tiene al cliente al teléfono.
La API — los mismos datos, las mismas reglas, sin navegador. Pensada para un script, un sitio web o un agente. Una clave API pertenece a una organización y lleva los derechos de quien la creó: nada es posible por la API que esa misma persona no pudiera hacer a mano.
La API es la mitad interesante de esta documentación. Ve a API — es el mapa de todos los endpoints, con una página por llamada.
Reglas que conviene conocer antes de nada
- Una franja fuera del horario de apertura de una villa se rechaza, igual que una duración ausente de su cuadrícula de tarifas. Ambos son propios de la villa, no de la organización. Las estancias de varios días son la única excepción al horario: una villa alquilada por noches no se juzga como una sesión de fotos por horas.
- Dos reservas confirmadas no pueden solaparse en la misma villa. El rechazo viene de la base de datos, no de una comprobación que una petición simultánea pudiera adelantar.
- Los importes son enteros en la unidad menor de tu moneda.
1500000enIDRson 15 000 rupias. Nunca dividas entre 100 sin conocer la moneda. - Tu plan tiene límites de villas, reservas y clientes. Alcanzar uno responde
409, tanto en la interfaz como en la API.
Y después
- Primeros pasos — la primera reserva, de principio a fin
- Reserva pública — deja que tus clientes reserven en línea, e intégrala en tu sitio web
- Integraciones — envía a tus clientes a una lista de email o a un webhook
- API — la autenticación, el sobre de respuesta y cada endpoint