Documentation

Journaux de livraison et tests

Les paramètres Webhooks incluent un journal d’envoi pour chaque destination. Utilisez-le pour vérifier l’arrivée des événements sur votre serveur, diagnostiquer les échecs et envoyer un nouvel exemple de données sans déclencher d’activité réelle.

Consulter les journaux d’envoi

1

Ouvrir Paramètres → Webhooks

Accédez à Dashboard → Settings → Webhooks.
2

Développer une ligne de webhook

Cliquez sur le Journaux de livraison sur une fiche webhook. Les 50 dernières tentatives d’envoi sont affichées, de la plus récente à la plus ancienne.
3

Inspecter chaque entrée

Chaque ligne affiche le type d’événement, le code de statut HTTP, le temps de réponse, l’horodatage et tout message d’erreur.

Champs du journal

ChampDescription
ÉvénementLe type d’événement déclenché (par exemple post.saved)
ÉtatStatut HTTP renvoyé par votre point de terminaison. null si le délai est dépassé ou la connexion refusée.
Temps de réponseDurée aller-retour en millisecondes, de l’envoi à la réception du dernier octet de la réponse.
RéussiteCoche verte = HTTP 2xx. Croix rouge = tout autre résultat.
ErreurErreur compréhensible pour les envois ayant échoué (par ex. Request timed out (10s)).
Livré leHorodatage UTC de la tentative d’envoi.

Envoyer un événement de test

1

Développer la carte du webhook

Dans Settings → Webhooks, trouvez votre webhook, puis cliquez sur Envoyer un événement de test.
2

Consultez le journal de livraison

L’envoi test apparaît en haut du journal des envois en quelques secondes. Vérifiez la présence de 200 état.

Les événements de test sont de vraies requêtes HTTP

L’événement de test suit exactement le même processus qu’un événement réel, y compris la signature HMAC. Votre code de vérification de signature est donc entièrement sollicité.

Aucune nouvelle tentative automatique

Chaque livraison est tentée une seule fois. Le journal sert uniquement au diagnostic ; aucun bouton ne permet de rejouer un événement en direct ayant échoué. Après avoir corrigé un point de terminaison, utilisez Tester pour vérifier la réparation.

Causes courantes d'échec

Erreur / StatutCause probableCorriger
Request timed out (10s)Le serveur a mis plus de 10 s à répondreRetour 200 immédiatement, puis traiter de manière asynchrone
401Échec de vérification de la signatureVeillez à lire le corps brut avant l’analyse JSON
404Le chemin de l’URL du point de terminaison n’existe pasVérifiez à nouveau l’URL dans les paramètres Webhooks de Savebase
500Erreur non gérée dans votre système de réceptionConsultez les journaux de votre serveur pour trouver l'exception
Connexion refusée / statut nullLe serveur est indisponible ou l’URL est incorrecteVérifiez que le serveur fonctionne et est accessible publiquement