Aller au contenu principal

    O seu próximo evento empresarial começa com uma API

    Pesquise espaços, envie pedidos e gira orçamentos com uma única API. Três chamadas enviam os primeiros pedidos; seguem-se orçamentos, confirmação e pagamento.

    A sua chave API

    É possível reservar um espaço para um evento empresarial através de uma API?

    Sim. A API BookAfterwork expõe todo o percurso: análise do briefing, recomendação de espaços com pontuação determinística, envio de pedidos, receção e comparação de orçamentos, confirmação. Autenticação por chave Bearer, idempotência, webhooks assinados e servidor MCP para agentes de IA. Gratuito para empresas, sem subscrição.

    • 3 chamadas para um briefing completo
    • Servidor MCP em 2 cliques
    • Webhooks assinados HMAC
    • OpenAPI 3.1

    Início rápido

    Envie o cabeçalho Authorization: Bearer (ou x-api-key) com uma chave bak_test_ ou bak_live_.

    # 1. Analisar o briefing
    curl -X POST https://bookafterwork.com/api/public/v1/requests \
      -H "Authorization: Bearer $BAK_API_KEY" \
      -H "Idempotency-Key: req-2026-03-12-lyon-1" \
      -H "Content-Type: application/json" \
      -d '{"message":"Afterwork 35 personnes à Lyon le 12 mars, 40€ par personne"}'
    # → { "request_id": "…", "brief": { … }, "missing_fields": [ … ] }
    
    # 2. Recomendar espaços
    curl -X POST https://bookafterwork.com/api/public/v1/ai/recommend \
      -H "Authorization: Bearer $BAK_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"request_id":"<request_id>","limit":6}'
    # → { "results": [ { "venue_id": "…", "match_score": 87, … } ] }
    
    # 3. Enviar os pedidos
    curl -X POST https://bookafterwork.com/api/public/v1/requests/<request_id>/dispatch \
      -H "Authorization: Bearer $BAK_API_KEY" \
      -H "Idempotency-Key: dispatch-<request_id>-1" \
      -H "Content-Type: application/json" \
      -d '{"venue_ids":["<venue_id_1>","<venue_id_2>"]}'

    Principais endpoints

    POST
    /api/public/v1/ai/parse-requestTransforma uma frase num briefing estruturado (cidade, data, participantes, orçamento).
    POST
    /api/public/v1/venues/searchPesquisa filtrada de espaços: cidade, capacidade, equipamentos, ambiente.
    POST
    /api/public/v1/requestsCria um pedido de evento.
    POST
    /api/public/v1/ai/recommendClassificação dos espaços com pontuação explicada (local, capacidade, orçamento, disponibilidade, reatividade).
    POST
    /api/public/v1/requests/{request_id}/dispatchEnvia o pedido aos espaços escolhidos.
    GET
    /api/public/v1/requests/{request_id}/quotesObtém os orçamentos recebidos.
    POST
    /api/public/v1/ai/compare-quotesCompara os orçamentos (total, preço/pess., melhor relação qualidade-preço).
    POST
    /api/public/v1/bookingsConfirma a reserva.
    GET
    /api/public/v1/bookings/{booking_id}
    POST
    /api/public/v1/bookings/{booking_id}/payment

    Servidor MCP em dois cliques

    Adicione o URL abaixo ao seu cliente compatível com MCP, autorize o acesso via OAuth 2.1 e o seu agente passa a ter quatro ferramentas: pesquisa de espaços, lista de cidades, criação de um pedido de evento e acompanhamento dos pedidos.

    https://bookafterwork.com/.well-known/mcp.json

    Detalhe das ferramentas, esquemas e configuração: guia do servidor MCP de eventos.

    Exemplo: comando Slack em 20 linhas

    As suas equipas escrevem uma frase no Slack e a API devolve três espaços disponíveis com preço por pessoa.

    // Comando Slack: /afterwork 35 pess. Lyon 12 de março 40€
    const BASE = "https://bookafterwork.com/api/public/v1";
    const headers = {
      Authorization: `Bearer ${process.env.BAK_API_KEY}`,
      "Content-Type": "application/json",
    };
    
    export default async function handler(req, res) {
      const created = await fetch(`${BASE}/requests`, {
        method: "POST",
        headers: { ...headers, "Idempotency-Key": `slack-${req.body.trigger_id}` },
        body: JSON.stringify({ message: req.body.text }),
      }).then((r) => r.json());
    
      const reco = await fetch(`${BASE}/ai/recommend`, {
        method: "POST",
        headers,
        body: JSON.stringify({ request_id: created.request_id, limit: 3 }),
      }).then((r) => r.json());
    
      res.json({
        response_type: "in_channel",
        text: reco.results
          .map((v) => `${v.name} — ${v.capacity ?? "?"} pers. — score ${v.match_score}/100`)
          .join("\n"),
      });
    }

    Passo a passo completo: integração Slack para eventos.

    Quotas e segurança

    Chaves com hash SHA-256, scopes por chave, expiração e revogação, quotas por chave e por IP, registo de utilização completo, proteção anti-bot nas rotas públicas.

    Idempotência

    Cabeçalho Idempotency-Key em todas as escritas: uma repetição devolve a resposta original, sem pedidos nem reservas duplicados.

    Webhooks

    Assinatura HMAC SHA-256, novas tentativas aos 1, 5, 30, 120 e 720 minutos, histórico de entregas consultável.

    Perguntas frequentes

    Como obter uma chave API BookAfterwork?

    Crie uma conta gratuita e gere a sua chave de teste (bak_test_) com um clique nesta página — fica ativa de imediato. A chave de produção (bak_live_) é emitida após a validação do seu caso de uso através da página de contacto. As chaves são guardadas com hash SHA-256 e podem ser revogadas ou rodadas a qualquer momento.

    Um agente de IA pode reservar de ponta a ponta?

    Sim. Todo o percurso está exposto: análise do briefing em linguagem natural, recomendação de espaços com pontuação determinística, envio de pedidos, receção de orçamentos, comparação e confirmação da reserva. A IA serve apenas para compreender o pedido: preços, capacidades e disponibilidades vêm sempre da base de dados e dos próprios espaços.

    A API é compatível com MCP?

    Sim. O servidor MCP está declarado em /.well-known/mcp.json com OAuth 2.1 e expõe quatro ferramentas: pesquisa de espaços, lista de cidades, criação de um pedido de evento e acompanhamento dos seus pedidos. Liga-se em dois cliques a um cliente compatível (Claude, ChatGPT, agentes internos).

    Como são geridos a idempotência e os webhooks?

    Cada escrita aceita um cabeçalho Idempotency-Key: uma repetição devolve a primeira resposta. Os webhooks são assinados (HMAC SHA-256) e reenviados aos 1, 5, 30, 120 e depois 720 minutos.