Un webhook envoie une requête POST à votre serveur quand un événement se produit sur un projet, par exemple quand le site devient injoignable.

Créer un webhook

  1. Dans Paramètres → Webhooks, créez un webhook.
  2. Renseignez une URL HTTPS et choisissez les événements.
  3. Copiez le secret de signature (whsec_…). Il n’est affiché qu’une fois.
Vous pouvez ensuite activer, désactiver ou supprimer le webhook, et consulter ses 50 dernières livraisons.

Événements

Les événements « Prévu » peuvent déjà être sélectionnés, mais ne sont pas encore envoyés.
La disponibilité est vérifiée environ toutes les 30 minutes. Un webhook n’est envoyé qu’au changement d’état : un site qui reste hors ligne ne déclenche pas une alerte à chaque vérification.

Requête reçue

http_status peut être null si le site n’a pas répondu du tout. Répondez avec un statut 2xx en moins de 10 secondes. Les redirections ne sont pas suivies.

Vérifier la signature

X-Jichio-Signature contient sha256= suivi du HMAC-SHA256 du corps brut de la requête, calculé avec le secret du webhook. Calculez-le de votre côté avant de traiter la requête :
Utilisez le corps avant tout parsing JSON : une simple différence d’espaces change la signature.

Nouvelles tentatives

Si votre serveur ne répond pas 2xx, la livraison est retentée jusqu’à 5 fois, après 1, 5, 15, 60 puis 240 minutes. Utilisez X-Jichio-Delivery-Id pour ignorer une livraison déjà traitée.