Aller au contenu principal

    Il tuo prossimo evento aziendale inizia con un'API

    Cerca location, invia richieste e gestisci i preventivi con un'unica API. Tre chiamate inviano le prime richieste; seguono preventivi, conferma e pagamento.

    La tua chiave API

    Si può prenotare una location per un evento aziendale tramite API?

    Sì. L'API BookAfterwork espone l'intero percorso: analisi del brief, raccomandazione di location con punteggio deterministico, invio delle richieste, ricezione e confronto dei preventivi, conferma. Autenticazione con chiave Bearer, idempotenza, webhook firmati e server MCP per gli agenti IA. Gratuito per le aziende, senza abbonamento.

    • 3 chiamate per un brief completo
    • Server MCP in 2 clic
    • Webhook firmati HMAC
    • OpenAPI 3.1

    Avvio rapido

    Invia l'header Authorization: Bearer (o x-api-key) con una chiave bak_test_ o bak_live_.

    # 1. Analizzare il brief
    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. Raccomandare location
    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. Inviare le richieste
    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>"]}'

    Endpoint principali

    POST
    /api/public/v1/ai/parse-requestTrasforma una frase in un brief strutturato (città, data, partecipanti, budget).
    POST
    /api/public/v1/venues/searchRicerca filtrata di location: città, capienza, dotazioni, atmosfera.
    POST
    /api/public/v1/requestsCrea una richiesta di evento.
    POST
    /api/public/v1/ai/recommendClassifica delle location con punteggio spiegato (luogo, capienza, budget, disponibilità, reattività).
    POST
    /api/public/v1/requests/{request_id}/dispatchInvia la richiesta alle location scelte.
    GET
    /api/public/v1/requests/{request_id}/quotesRecupera i preventivi ricevuti.
    POST
    /api/public/v1/ai/compare-quotesConfronta i preventivi (totale, prezzo/pers., miglior rapporto qualità-prezzo).
    POST
    /api/public/v1/bookingsConferma la prenotazione.
    GET
    /api/public/v1/bookings/{booking_id}
    POST
    /api/public/v1/bookings/{booking_id}/payment

    Server MCP in due clic

    Aggiungi l'URL qui sotto nel tuo client compatibile MCP, autorizza l'accesso tramite OAuth 2.1 e il tuo agente avrà quattro strumenti: ricerca di location, elenco delle città, creazione di una richiesta di evento e monitoraggio delle richieste.

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

    Dettagli su strumenti, schemi e configurazione: guida al server MCP per eventi.

    Esempio: comando Slack in 20 righe

    I tuoi team scrivono una frase su Slack, l'API restituisce tre location disponibili con prezzo a persona.

    // Comando Slack: /afterwork 35 pers. Lione 12 marzo 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"),
      });
    }

    Guida completa: integrazione Slack per eventi.

    Quote e sicurezza

    Chiavi con hash SHA-256, scope per chiave, scadenza e revoca, quote per chiave e per IP, registro di utilizzo completo, protezione anti-bot sulle rotte pubbliche.

    Idempotenza

    Header Idempotency-Key su tutte le scritture: una ripetizione restituisce la risposta originale, senza richieste o prenotazioni duplicate.

    Webhook

    Firma HMAC SHA-256, nuovi tentativi a 1, 5, 30, 120 e 720 minuti, cronologia delle consegne consultabile.

    Domande frequenti

    Come ottenere una chiave API BookAfterwork?

    Crea un account gratuito e genera la tua chiave di test (bak_test_) con un clic da questa pagina: è attiva subito. La chiave di produzione (bak_live_) viene rilasciata dopo la convalida del tuo caso d'uso tramite la pagina contatti. Le chiavi sono salvate con hash SHA-256 e possono essere revocate o ruotate in qualsiasi momento.

    Un agente IA può prenotare dall'inizio alla fine?

    Sì. L'intero percorso è esposto: analisi del brief in linguaggio naturale, raccomandazione di location con punteggio deterministico, invio delle richieste, ricezione dei preventivi, confronto e conferma della prenotazione. L'IA serve solo a capire la richiesta: prezzi, capienze e disponibilità provengono sempre dal database e dalle location stesse.

    L'API è compatibile con MCP?

    Sì. Il server MCP è dichiarato su /.well-known/mcp.json con OAuth 2.1 ed espone quattro strumenti: ricerca di location, elenco delle città, creazione di una richiesta di evento e monitoraggio delle richieste. Si collega in due clic a un client compatibile (Claude, ChatGPT, agenti interni).

    Come vengono gestiti idempotenza e webhook?

    Ogni scrittura accetta un header Idempotency-Key: una ripetizione restituisce la prima risposta. I webhook sono firmati (HMAC SHA-256) e ritentati a 1, 5, 30, 120 e poi 720 minuti.