Hoje estamos abrindo a plataforma hoastnow para desenvolvedores. O novo Portal de Desenvolvedores oferece acesso programático à disponibilidade, reservas, avaliações, webhooks e integração com agentes de IA — tudo o que você precisa para construir sobre a mesma infraestrutura que alimenta o mercado hoastnow para ativação de marcas em comunidades residenciais.
Por que uma API pública?
Comunidades e marcas têm pedido formas de integrar o hoastnow em suas próprias ferramentas — sites, widgets de reserva, painéis internos e assistentes com IA. Até agora, cada integração exigia trabalho personalizado da nossa parte. O Portal de Desenvolvedores hoastnow muda isso. Com uma única chave API, você pode consultar disponibilidade ao vivo, criar e gerenciar reservas, recuperar dados de avaliações e assinar eventos em tempo real via webhooks.
Dois tipos de chave, um modelo de permissão
A API é segmentada por tipo de chave para corresponder aos dois lados do mercado 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 dos espaços em seu próprio site ou alimentar dados em ferramentas analíticas. Chaves de comunidade nunca podem criar reservas.
Chaves de Marca
Acesso completo para reservas em nome de uma marca. Use-as para construir fluxos de reserva personalizados, automatizar reservas recorrentes ou integrar o hoastnow na sua pilha de planejamento de eventos. Chaves de marca nunca podem ver dados fora de sua própria marca.
As chaves são geradas e revogadas no painel da sua conta. Cada chave possui 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. Veja o que está disponível no lançamento.
Verificar disponibilidade
Consulte janelas abertas para qualquer espaço por data, com filtros configuráveis de duração. 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 um horário 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
Busque resumos e classificações de avaliações para espaços e marcas. Útil para incorporar prova social no seu próprio site.
Eventos webhook
Assine os eventos booking.created, booking.updated e booking.cancelled. Seu endpoint recebe um POST assinado em segundos após qualquer mudança de estado.
Suporte a agente de IA via MCP
Protocolo de Contexto de Modelo
Junto com a API REST, estamos lançando um servidor nativo do Protocolo de Contexto de Modelo (MCP). O MCP permite que agentes de IA — Claude, Cursor, Copilot e qualquer cliente compatível — pesquisem comunidades, verifiquem disponibilidade e criem reservas sem precisar de scraping de tela ou código de integração personalizado.
A mesma chave API e modelo de permissão governa 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 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 completa das integrações de IA do hoastnow, veja hoastnow está agora disponível no ChatGPT, Claude, Grok e Gemini.
"A mesma chave API e modelo de permissão governa tudo — REST e MCP. Uma chave, uma integração, todo o mercado hoastnow."
Começando
Acesse o Portal de Desenvolvedores para gerar sua primeira chave API. A Referência da API documenta cada endpoint com exemplos de requisição/resposta, e a página Início Rápido guia você pelos padrões comuns de integração do começo ao fim.
Se você tiver qualquer problema ou quiser compartilhar o que está construindo, entre em contato pelo hello@hoastnow.com. Nós lemos tudo.
Pronto para construir no hoastnow?
Gere sua primeira chave API e comece a integrar em minutos.
Visite o Portal de Desenvolvedores ↗