Réservez un lieu d'entreprise par API
Une API pensée pour les agents : trois appels suffisent pour passer d'une phrase en langage naturel à des demandes envoyées aux lieux. Serveur MCP inclus, webhooks signés, spécification OpenAPI 3.1.
Votre clé API
Peut-on réserver un lieu d'événement d'entreprise via une API ?
Oui. L'API BookAfterwork expose le parcours complet : analyse du brief, recommandation de lieux avec score déterministe, envoi des demandes, réception et comparaison des devis, confirmation. Authentification par clé Bearer, idempotence, webhooks signés et serveur MCP pour les agents IA. Gratuit pour l'entreprise, sans abonnement.
- 3 appels pour un brief complet
- Serveur MCP en 2 clics
- Webhooks signés HMAC
- OpenAPI 3.1
Démarrage rapide
Passez l'en-tête Authorization: Bearer (ou x-api-key) avec une clé bak_test_ ou bak_live_.
# 1. Analyser le 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. Recommander des lieux
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. Envoyer les demandes
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>"]}'Points d'entrée principaux
/api/v1/ai/parse-requestTransforme une phrase en brief structuré (ville, date, participants, budget)./api/v1/venues/searchRecherche de lieux filtrée : ville, capacité, équipements, ambiance./api/v1/ai/recommendClassement des lieux avec score expliqué (lieu, capacité, budget, disponibilité, réactivité)./api/v1/requestsCrée une demande d'événement./api/v1/requests/{id}/dispatchEnvoie la demande aux lieux choisis./api/v1/requests/{id}/quotesRécupère les devis reçus./api/v1/ai/compare-quotesCompare les devis (total, prix/pers, meilleur rapport)./api/v1/bookingsConfirme la réservation.Serveur MCP en deux clics
Ajoutez l'URL ci-dessous dans votre client compatible MCP, autorisez l'accès via OAuth 2.1, et votre agent dispose de quatre outils : recherche de lieux, liste des villes, création d'une demande d'événement et suivi des demandes.
https://bookafterwork.com/.well-known/mcp.jsonDétail des outils, schémas et configuration : guide du serveur MCP événementiel.
Exemple : commande Slack en 20 lignes
Vos équipes tapent une phrase dans Slack, l'API renvoie trois lieux disponibles avec prix par personne.
// Slash command Slack : /afterwork 35 pers Lyon 12 mars 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"),
});
}Pas à pas complet : intégration Slack événementiel.
Quotas & sécurité
Clés hachées SHA-256, scopes par clé, expiration et révocation, quotas par clé et par IP, journal d'usage complet, protection anti-bot sur les routes publiques.
Idempotence
En-tête Idempotency-Key sur toutes les écritures : un rejeu renvoie la réponse d'origine, sans doublon de demande ni de réservation.
Webhooks
Signature HMAC SHA-256, réessais à 1, 5, 30, 120 et 720 minutes, historique des livraisons consultable.
Questions fréquentes
Comment obtenir une clé API BookAfterwork ?
Créez un compte gratuit puis générez votre clé de test (bak_test_) en un clic depuis cette page — elle est active immédiatement. La clé de production (bak_live_) est délivrée après validation de votre cas d'usage via la page contact. Les clés sont stockées hachées en SHA-256 et peuvent être révoquées ou rotées à tout moment.
Un agent IA peut-il réserver de bout en bout ?
Oui. Le parcours complet est exposé : analyse du brief en langage naturel, recommandation de lieux avec score déterministe, envoi des demandes, réception des devis, comparaison puis confirmation de réservation. L'IA ne sert qu'à comprendre la demande : les prix, capacités et disponibilités viennent toujours de la base et des lieux eux-mêmes.
L'API est-elle compatible MCP ?
Oui. Le serveur MCP est déclaré sur /.well-known/mcp.json avec OAuth 2.1 et expose quatre outils : recherche de lieux, liste des villes, création d'une demande d'événement et suivi de vos demandes. Il se branche en deux clics dans un client compatible (Claude, ChatGPT, agents internes).
Comment sont gérés l'idempotence et les webhooks ?
Chaque écriture accepte un en-tête Idempotency-Key : un rejeu renvoie la première réponse. Les webhooks sont signés (HMAC SHA-256) et réessayés à 1, 5, 30, 120 puis 720 minutes.