Webhook
Envoyez des événements de lecture vers l'URL de votre choix via un Webhook personnalisé. Idéal pour créer vos propres automatisations et intégrations.

Écran de configuration du Webhook
Les Webhooks vous permettent de recevoir des notifications en temps réel sur votre activité de lecture. Lorsqu'un événement se produit, Book Reading Habit envoie une requête HTTP POST avec les données de l'événement au format JSON vers l'URL que vous avez spécifiée.
Qu'est-ce qu'un Webhook ?
Les Webhooks vous permettent de recevoir des notifications en temps réel sur votre activité de lecture. Lorsqu'un événement se produit, Book Reading Habit envoie une requête HTTP POST avec les données de l'événement au format JSON vers l'URL que vous avez spécifiée.
Comment fonctionnent les Webhooks
Une fois votre URL de Webhook configurée, Book Reading Habit envoie automatiquement des notifications à chaque fois que certains événements se produisent :
- Un événement se produit dans Book Reading Habit (ex : fin d'une session de lecture)
- L'application envoie une requête HTTP POST vers votre URL de Webhook
- Votre serveur reçoit le payload JSON et peut le traiter comme vous le souhaitez
Configuration
Configurez votre Webhook avec les paramètres suivants :
Nom du Webhook
Un nom pour identifier ce Webhook
URL du Webhook
L'URL vers laquelle les requêtes POST seront envoyées
Clé secrète (optionnelle)
Si renseignée, les requêtes incluront un en-tête X-Signature-256 avec une signature HMAC pour la vérification
Événements
Sélectionnez les événements qui déclencheront ce Webhook
Format du payload
Tous les payloads Webhook sont envoyés en JSON avec la structure suivante :
{
"eventType": "session.completed",
"timestamp": "2024-12-04T10:30:00Z",
"book": { ... },
"session": { ... },
"metadata": null
}En savoir plus
Types d'événements
Liste complète des 16 événements auxquels vous pouvez vous abonner
Structure du payload
Structure détaillée du payload Webhook avec tous les champs
Bonnes pratiques de sécurité
Utilisez toujours des URL HTTPS et définissez une clé secrète pour valider les requêtes Webhook. La clé secrète est utilisée pour générer une signature HMAC que vous pouvez vérifier côté serveur.