Démarrer l’essai gratuit

Intégration · Développeurs

Alertes signées via webhooks

Chaque alerte en JSON vers votre propre endpoint, signée en HMAC-SHA256 pour prouver qu’elle provient d’Uptimecheck.

Démarrer l’essai gratuit Essayer la démo en direct

Essai gratuit de 14 jours · Puis gratuit pour 5 moniteurs · Sans carte bancaire

Ce que vous obtenez

  • Requêtes signées

    Chaque POST contient x-uptimecheck-timestamp et x-uptimecheck-signature : un HMAC-SHA256 de l’horodatage et du corps, avec le secret de signature du canal comme clé.

  • Des noms d’événements clairs

    monitor.down, monitor.up, monitor.slow, certificate.expiring, dns.changed et plus encore, pour que votre code se base sur un seul champ.

  • Un incident, des deux côtés

    monitor.down et monitor.up portent le même identifiant d’incident, ce qui vous permet d’ouvrir et de clôturer l’enregistrement correspondant de votre côté.

  • Nouvelles tentatives intégrées

    Toute réponse autre qu’un 2xx dans les 10 secondes est renvoyée après 30 secondes, puis 2, 10 et 30 minutes. Un 410 Gone arrête les nouvelles tentatives.

Comment connecter Webhooks

  1. Ouvrez Canaux d’alerte dans la barre latérale et choisissez Ajouter un canal.

  2. Choisissez Webhook et saisissez l’URL de l’endpoint.

  3. Choisissez Add channel et copiez le secret de signature qui s’affiche. Il n’est montré qu’une seule fois.

  4. Choisissez Send test pour envoyer un événement de test à votre endpoint.

Tous les champs et une version Python de la vérification se trouvent dans la référence de l’API.

Inclus dans toutes les formules, y compris Free.

Mise en place Comment configurer et vérifier les alertes webhook

Ce qui arrive

monitor.down
Une panne confirmée
monitor.up
Le rétablissement, avec la durée d’indisponibilité
monitor.slow
Réponses au-delà de votre seuil
monitor.fast
De nouveau sous la limite
certificate.expiring
Un certificat TLS expire bientôt ou a expiré
domain.expiring
Un nom de domaine expire bientôt ou a expiré
dns.changed
Enregistrements DNS modifiés, avec l’avant et l’après
server.rebooted
Un serveur équipé de l’agent a redémarré
site.issues
Nouveaux liens cassés ou contenu mixte
site.performance_dropped
Le score de vitesse mobile d’une page est passé sous votre seuil
domain.email_issues
Nouveaux problèmes dans la configuration e-mail d’un domaine
test
Envoyé par « Send test »

POST vers votre endpoint

x-uptimecheck-timestamp: 1792120324
x-uptimecheck-signature: sha256=5d2c…e81f

{
  "event": "monitor.down",
  "workspace": "Northwind",
  "monitor": {
    "id": "mon_9xk2m1q8w4",
    "name": "Checkout",
    "target": "https://northwind.shop/checkout",
    "url": "https://app.uptimecheck.com/w/northwind/monitors/mon_9xk2m1q8w4"
  },
  "incident": {
    "id": "inc_7b3t9r2m5c",
    "url": "https://app.uptimecheck.com/w/northwind/incidents/inc_7b3t9r2m5c"
  },
  "cause": "HTTP 502",
  "regions": ["eu-north"],
  "at": "2026-10-16T03:12:04.000Z",
  "downtimeSeconds": null,
  "explanation": null
}
Un événement monitor.down. monitor.up porte le même ID d’incident et la durée d’indisponibilité en secondes.

Questions

Comment vérifier la signature ?

Calculez un HMAC-SHA256 sur la valeur x-uptimecheck-timestamp, un point et le corps brut de la requête, avec le secret de signature comme clé. Comparez-le en temps constant avec la valeur hexadécimale qui suit sha256= dans x-uptimecheck-signature, et rejetez les horodatages trop anciens.

Quels événements sont envoyés ?

monitor.down, monitor.up, monitor.slow, monitor.fast, certificate.expiring, domain.expiring, dns.changed, server.rebooted, site.issues, site.performance_dropped, domain.email_issues et test.

Que se passe-t-il quand mon endpoint est en panne ?

Une requête qui n’obtient pas de réponse 2xx en 10 secondes est retentée quatre fois, après 30 secondes, 2 minutes, 10 minutes et 30 minutes. Ensuite, le canal affiche Not delivering avec la dernière erreur. Répondre 410 Gone arrête immédiatement les nouvelles tentatives.

Puis-je revoir le secret de signature ?

Non. Il n’est affiché qu’une fois, quand vous ajoutez le canal, et il ne change jamais. Pour un nouveau secret, ajoutez un nouveau canal webhook et supprimez l’ancien.

Les abonnés de notre page de statut peuvent-ils aussi suivre ici ?

Oui. Les visiteurs d’une page de statut Uptimecheck peuvent la suivre dans Slack, Microsoft Teams, Discord ou par webhook, pour toute la page ou uniquement pour les composants de leur choix, et y recevoir vos mises à jour de statut.

Est-ce inclus dans toutes les formules ?

Oui. Tous les canaux d’alerte sauf les SMS sont disponibles sur toutes les offres, y compris l’offre Free ; les SMS nécessitent une offre payante et utilisent des crédits (inclus dans Professional et Business, en packs achetés sur Start). Les offres diffèrent par le nombre de canaux d’alerte que vous pouvez ajouter : 3 sur Free, 25 sur Start, 75 sur Professional et 250 sur Business.

Fonctionne avec

Toutes les intégrations

Les pannes, c’est du passé.

Configurez votre premier moniteur en moins d’une minute, ou explorez d’abord la démo en ligne.

Démarrer l’essai gratuit Comparer les offres

Essai gratuit de 14 jours · Puis gratuit pour 5 moniteurs · Sans carte bancaire