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