Webhooks

Events‑ERP peut notifier votre application lorsqu'une réservation est créée via l'API. Il s'agit d'un webhook sortant (Events‑ERP appelle votre URL).

#Configuration

Dans le dashboard Gérant, section API développeur, renseignez l'URL de webhook sortant (HTTPS recommandé). Enregistrez la configuration avec vos domaines CORS autorisés.

#Format des événements

Chaque notification est une requête POST avec le header Content-Type: application/json.

{
  "event": "booking.created",
  "bookingId": 42,
  "status": "PENDING_PAYMENT",
  "clientId": 12,
  "serviceId": "clx9abc123def456",
  "at": "2026-06-02T12:00:00.000Z"
}

Le champ atindique l'horodatage UTC de l'envoi. Les autres propriétés dépendent de l'événement.

#Événements disponibles

• booking.created — Émis après une création réussie via POST /api/v1/bookings

D'autres événements (paiement confirmé, annulation) pourront être ajoutés dans les prochaines versions ; consultez le changelog produit.

#Bonnes pratiques

#Idempotence

Traitez les notifications de manière idempotente : le même bookingId peut théoriquement être reçu si vous relancez un flux côté client.

#Délai de réponse

Répondez rapidement avec un code 2xx. Le traitement lourd (emails, ERP tiers) doit être mis en file côté votre serveur.

#Sécurité

• Utiliser HTTPS uniquement
• Vérifier l'origine des appels (IP / secret partagé — à renforcer selon votre déploiement)
• Ne pas exposer de données sensibles dans l'URL du webhook