Webhook

Les webhooks permettent à Batis de notifier un système externe lorsqu'un événement métier se produit.

Un webhook sert à déclencher une action côté client sans polling permanent : synchroniser un état, intégrer une écriture comptable, récupérer un document finalisé ou alimenter un outil interne.

Principes

• Le système client expose une URL de réception.
• Batis envoie un payload JSON lorsqu'un événement est disponible.
• Le récepteur doit être idempotent : un même événement peut être envoyé plusieurs fois.
• En cas d'échec temporaire, Batis peut réessayer l'envoi.

À documenter dans la référence webhook

• liste des événements ;
• format des payloads ;
• signature des requêtes ;
• stratégie de retry ;
• règles d'idempotence.