Tu próximo evento de empresa empieza con una API
Busca espacios, envía solicitudes y gestiona presupuestos desde una sola API. Tres llamadas envían tus primeras solicitudes; después llegan presupuestos, confirmación y pago.
Su clave API
¿Se puede reservar un espacio para un evento de empresa mediante una API?
Sí. La API de BookAfterwork expone todo el recorrido: análisis del brief, recomendación de espacios con puntuación determinista, envío de solicitudes, recepción y comparación de presupuestos, confirmación. Autenticación por clave Bearer, idempotencia, webhooks firmados y servidor MCP para agentes de IA. Gratis para la empresa, sin suscripción.
- 3 llamadas para un brief completo
- Servidor MCP en 2 clics
- Webhooks firmados HMAC
- OpenAPI 3.1
Inicio rápido
Envíe la cabecera Authorization: Bearer (o x-api-key) con una clave bak_test_ o bak_live_.
# 1. Analizar el 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. Recomendar espacios
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 las solicitudes
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>"]}'Principales endpoints
/api/public/v1/ai/parse-requestConvierte una frase en un brief estructurado (ciudad, fecha, participantes, presupuesto)./api/public/v1/venues/searchBúsqueda filtrada de espacios: ciudad, capacidad, equipamiento, ambiente./api/public/v1/requestsCrea una solicitud de evento./api/public/v1/ai/recommendClasificación de espacios con puntuación explicada (ubicación, capacidad, presupuesto, disponibilidad, reactividad)./api/public/v1/requests/{request_id}/dispatchEnvía la solicitud a los espacios elegidos./api/public/v1/requests/{request_id}/quotesRecupera los presupuestos recibidos./api/public/v1/ai/compare-quotesCompara los presupuestos (total, precio/pers., mejor relación calidad-precio)./api/public/v1/bookingsConfirma la reserva./api/public/v1/bookings/{booking_id}/api/public/v1/bookings/{booking_id}/paymentServidor MCP en dos clics
Añada la URL siguiente en su cliente compatible con MCP, autorice el acceso mediante OAuth 2.1 y su agente dispondrá de cuatro herramientas: búsqueda de espacios, lista de ciudades, creación de una solicitud de evento y seguimiento de solicitudes.
https://bookafterwork.com/.well-known/mcp.jsonDetalle de herramientas, esquemas y configuración: guía del servidor MCP de eventos.
Ejemplo: comando Slack en 20 líneas
Sus equipos escriben una frase en Slack y la API devuelve tres espacios disponibles con precio por persona.
// Comando Slack: /afterwork 35 pers. Lyon 12 de 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"),
});
}Paso a paso completo: integración Slack para eventos.
Cuotas y seguridad
Claves con hash SHA-256, scopes por clave, caducidad y revocación, cuotas por clave y por IP, registro de uso completo, protección antibots en las rutas públicas.
Idempotencia
Cabecera Idempotency-Key en todas las escrituras: una repetición devuelve la respuesta original, sin solicitudes ni reservas duplicadas.
Webhooks
Firma HMAC SHA-256, reintentos a los 1, 5, 30, 120 y 720 minutos, historial de entregas consultable.
Preguntas frecuentes
¿Cómo obtener una clave API de BookAfterwork?
Cree una cuenta gratuita y genere su clave de prueba (bak_test_) con un clic desde esta página: se activa al instante. La clave de producción (bak_live_) se entrega tras validar su caso de uso a través de la página de contacto. Las claves se almacenan con hash SHA-256 y pueden revocarse o rotarse en cualquier momento.
¿Puede un agente de IA reservar de principio a fin?
Sí. Todo el recorrido está expuesto: análisis del brief en lenguaje natural, recomendación de espacios con puntuación determinista, envío de solicitudes, recepción de presupuestos, comparación y confirmación de la reserva. La IA solo sirve para entender la solicitud: precios, capacidades y disponibilidad provienen siempre de la base de datos y de los propios espacios.
¿La API es compatible con MCP?
Sí. El servidor MCP está declarado en /.well-known/mcp.json con OAuth 2.1 y expone cuatro herramientas: búsqueda de espacios, lista de ciudades, creación de una solicitud de evento y seguimiento de sus solicitudes. Se conecta en dos clics a un cliente compatible (Claude, ChatGPT, agentes internos).
¿Cómo se gestionan la idempotencia y los webhooks?
Cada escritura acepta una cabecera Idempotency-Key: una repetición devuelve la primera respuesta. Los webhooks están firmados (HMAC SHA-256) y se reintentan a los 1, 5, 30, 120 y luego 720 minutos.
