Hoy abrimos la plataforma hoastnow a los desarrolladores. El nuevo Portal para Desarrolladores te brinda acceso programático a disponibilidad, reservas, reseñas, webhooks e integración con agentes de IA: todo lo que necesitas para construir sobre la misma infraestructura que impulsa el marketplace de hoastnow para activaciones de marca en comunidades residenciales.
¿Por qué una API pública?
Las comunidades y las marcas han estado pidiendo formas de integrar hoastnow en sus propias herramientas: sitios web, widgets de reservas, paneles internos y asistentes impulsados por IA. Hasta ahora, cada integración requería trabajo personalizado de nuestra parte. El Portal para Desarrolladores de hoastnow cambia eso. Con una sola clave de API puedes consultar disponibilidad en vivo, crear y gestionar reservas, recuperar datos de reseñas y suscribirte a eventos en tiempo real a través de webhooks.
Dos tipos clave, un modelo de permisos
La API se delimita por tipo de clave para coincidir con los dos lados del marketplace de hoastnow.
Claves de Comunidad
Acceso de solo lectura limitado a los espacios dentro de una sola comunidad. Úsalas para incrustar calendarios de disponibilidad, mostrar detalles de espacios en tu propio sitio web o alimentar datos en herramientas de análisis. Las claves de comunidad nunca pueden crear reservas.
Claves de Marca
Acceso completo de reserva en nombre de una marca. Úsalas para construir flujos de reserva personalizados, automatizar reservas repetitivas o integrar hoastnow en tu stack de planificación de eventos. Las claves de marca nunca pueden ver datos fuera de su propia marca.
Las claves se generan y revocan desde tu panel de cuenta. Cada clave tiene los permisos mínimos necesarios para su función.
Qué puedes construir hoy
La API v1 cubre el ciclo de vida principal de las reservas. Esto es lo que está disponible en el lanzamiento.
Consultar disponibilidad
Consulta ventanas abiertas para cualquier espacio por fecha, con filtros de duración configurables. Los resultados incluyen las ventanas de reserva definidas por la comunidad y una tarifa plana por evento.
Crear reservas
Envía una solicitud de reserva con una hora de inicio. La API valida la ventana, aplica las reglas de la comunidad y devuelve la reserva confirmada o un error claro.
Leer reseñas
Obtén resúmenes de reseñas y calificaciones para espacios y marcas. Útil para incrustar prueba social en tu propio sitio.
Eventos webhook
Suscríbete a eventos booking.created, booking.updated y booking.cancelled. Tu endpoint recibe un POST firmado en segundos de cualquier cambio de estado.
Soporte para agentes de IA mediante MCP
Protocolo de Contexto de Modelo
Junto con la API REST, estamos lanzando un servidor nativo de Protocolo de Contexto de Modelo (MCP). MCP permite que los agentes de IA (Claude, Cursor, Copilot y cualquier cliente compatible) busquen comunidades, consulten disponibilidad y creen reservas sin necesidad de hacer screen-scraping ni código de integración personalizado.
La misma clave de API y modelo de permisos rige el acceso a MCP, por lo que no hay nada adicional que configurar. Conéctate al servidor MCP en https://app.hoastnow.com/mcp usando tu clave de API existente.
Desde allí, tu asistente de IA puede responder preguntas como "encuéntrame un espacio comunitario en Brickell disponible el sábado por la tarde" y reservarlo, todo en una sola conversación. Para una visión completa de las integraciones de IA de hoastnow, consulta hoastnow ya está disponible en ChatGPT, Claude, Grok y Gemini.
"La misma clave de API y modelo de permisos rige todo: REST y MCP. Una clave, una integración, todo el marketplace de hoastnow."
Cómo empezar
Dirígete al Portal para Desarrolladores para generar tu primera clave de API. La Referencia de la API documenta cada endpoint con ejemplos de solicitud/respuesta, y la página de Inicio Rápido recorre patrones de integración comunes de principio a fin.
Si encuentras algún problema o quieres compartir lo que estás construyendo, contáctanos en hello@hoastnow.com. Leemos todo.
¿Listo para construir sobre hoastnow?
Genera tu primera clave de API y comienza a integrar en minutos.
Visita el Portal para Desarrolladores ↗