Aller au contenu principal
Cette page a été traduite par IA et peut contenir des erreurs.

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.

Book Reading Habit app showing webhook configuration screen

É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

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.