Hoje estamos abrindo a plataforma hoastnow para desenvolvedores. O novo Portal do Desenvolvedor oferece acesso programático a disponibilidade, reservas, avaliações, webhooks e integração com agentes de IA — tudo o que você precisa para construir sobre a mesma infraestrutura que impulsiona o marketplace hoastnow para ativações de marca em comunidades residenciais.
Por que uma API pública?
Comunidades e marcas vêm pedindo maneiras de integrar o hoastnow em suas próprias ferramentas — sites, widgets de reserva, painéis internos e assistentes com inteligência artificial. Até agora, cada integração exigia trabalho personalizado de nossa parte. O Portal do Desenvolvedor hoastnow muda isso. Com uma única chave de API, você pode consultar disponibilidade em tempo real, criar e gerenciar reservas, recuperar dados de avaliações e se inscrever em eventos em tempo real via webhooks.
Dois tipos principais, um modelo de permissão
A API é delimitada por tipo de chave para corresponder aos dois lados do marketplace hoastnow.
Chaves de Comunidade
Acesso somente leitura limitado aos espaços dentro de uma única comunidade. Use-as para incorporar calendários de disponibilidade, exibir detalhes de espaços em seu próprio site ou alimentar dados em ferramentas de análise. Chaves de comunidade nunca podem criar reservas.
Chaves de Marca
Acesso completo de reserva em nome de uma marca. Use-as para construir fluxos de reserva personalizados, automatizar reservas repetitivas ou integrar o hoastnow em sua stack de planejamento de eventos. Chaves de marca nunca podem ver dados fora de sua própria marca.
As chaves são geradas e revogadas a partir do painel da sua conta. Cada chave carrega as permissões mínimas necessárias para sua função.
O que você pode construir hoje
A API v1 cobre o ciclo de vida principal das reservas. Aqui está o que está disponível no lançamento.
Consultar disponibilidade
Consulte janelas abertas para qualquer espaço por data, com filtros de duração configuráveis. Os resultados incluem as janelas de reserva definidas pela comunidade e uma taxa fixa por evento.
Criar reservas
Envie uma solicitação de reserva com uma hora de início. A API valida a janela, aplica as regras da comunidade e retorna a reserva confirmada ou um erro claro.
Ler avaliações
Obtenha resumos de avaliações e classificações para espaços e marcas. Útil para incorporar prova social em seu próprio site.
Eventos webhook
Inscreva-se em eventos booking.created, booking.updated e booking.cancelled. Seu endpoint recebe um POST assinado em segundos após qualquer mudança de estado.
Suporte para agentes de IA via MCP
Protocolo de Contexto de Modelo
Junto com a API REST, estamos lançando um servidor nativo de Protocolo de Contexto de Modelo (MCP). O MCP permite que agentes de IA — Claude, Cursor, Copilot e qualquer cliente compatível — pesquisem comunidades, consultem disponibilidade e criem reservas sem a necessidade de screen-scraping ou código de integração personalizado.
A mesma chave de API e modelo de permissão rege o acesso ao MCP, então não há nada extra para configurar. Conecte-se ao servidor MCP em https://app.hoastnow.com/mcp usando sua chave de API existente.
A partir daí, seu assistente de IA pode responder perguntas como "encontre um espaço comunitário em Brickell disponível no sábado à tarde" e reservá-lo — tudo em uma única conversa. Para uma visão geral completa das integrações de IA do hoastnow, consulte hoastnow agora está disponível no ChatGPT, Claude, Grok e Gemini.
"A mesma chave de API e modelo de permissão rege tudo — REST e MCP. Uma chave, uma integração, todo o marketplace hoastnow."
Primeiros passos
Acesse o Portal do Desenvolvedor para gerar sua primeira chave de API. A Referência da API documenta cada endpoint com exemplos de solicitação/resposta, e a página de Início Rápido percorre padrões de integração comuns do início ao fim.
Se você encontrar algum problema ou quiser compartilhar o que está construindo, entre em contato pelo e-mail hello@hoastnow.com. Lemos tudo.
Pronto para construir com hoastnow?
Gere sua primeira chave de API e comece a integrar em minutos.
Visite o Portal do Desenvolvedor ↗