Prenota una location aziendale via API
Un'API pensata per gli agenti: bastano tre chiamate per passare da una frase in linguaggio naturale a richieste inviate alle location. Server MCP incluso, webhook firmati, specifica OpenAPI 3.1.
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/v1/ai/parse-request \
-H "Authorization: Bearer $BAK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Afterwork 35 personnes à Lyon le 12 mars, 40€ par personne"}'
# 2. Raccomandare location
curl -X POST https://bookafterwork.com/api/v1/ai/recommend \
-H "Authorization: Bearer $BAK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"requestId":"<id>","limit":6}'
# 3. Inviare le richieste
curl -X POST https://bookafterwork.com/api/v1/requests/<id>/dispatch \
-H "Authorization: Bearer $BAK_API_KEY" \
-H "Idempotency-Key: dispatch-<id>-1" \
-H "Content-Type: application/json" \
-d '{"venueIds":["<venue-1>","<venue-2>"]}'Endpoint principali
/api/v1/ai/parse-requestTrasforma una frase in un brief strutturato (città, data, partecipanti, budget)./api/v1/venues/searchRicerca filtrata di location: città, capienza, dotazioni, atmosfera./api/v1/ai/recommendClassifica delle location con punteggio spiegato (luogo, capienza, budget, disponibilità, reattività)./api/v1/requestsCrea una richiesta di evento./api/v1/requests/{id}/dispatchInvia la richiesta alle location scelte./api/v1/requests/{id}/quotesRecupera i preventivi ricevuti./api/v1/ai/compare-quotesConfronta i preventivi (totale, prezzo/pers., miglior rapporto qualità-prezzo)./api/v1/bookingsConferma la prenotazione.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.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€
export default async function handler(req, res) {
const brief = await fetch("https://bookafterwork.com/api/v1/ai/parse-request", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.BAK_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ text: req.body.text }),
}).then((r) => r.json());
const reco = await fetch("https://bookafterwork.com/api/v1/ai/recommend", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.BAK_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ requestId: brief.requestId, limit: 3 }),
}).then((r) => r.json());
res.json({
response_type: "in_channel",
text: reco.recommendations
.map((v) => `${v.name} — ${v.capacity} pers. — ${v.price_per_person}€/pers`)
.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.