Integracja · Dla deweloperów

Alerty jako podpisane webhooki

Każdy alert jako JSON do Twojego własnego endpointu, podpisany HMAC-SHA256, abyś mógł udowodnić, że pochodzi z Uptimecheck.

14 dni za darmo · Potem 5 monitorów gratis · Bez karty kredytowej

Co otrzymujesz

  • Podpisane żądania

    Każde żądanie POST zawiera x-uptimecheck-timestamp i x-uptimecheck-signature: HMAC-SHA256 znacznika czasu i treści, z sekretem podpisu kanału jako kluczem.

  • Jasne nazwy zdarzeń

    monitor.down, monitor.up, monitor.slow, certificate.expiring, dns.changed i inne, więc Twój kod rozgałęzia się na podstawie jednego pola.

  • Jeden incydent, oba końce

    monitor.down i monitor.up mają ten sam identyfikator incydentu, więc możesz otworzyć i zamknąć odpowiedni rekord po swojej stronie.

  • Wbudowane ponowienia

    Każda odpowiedź inna niż 2xx w ciągu 10 sekund jest ponawiana po 30 sekundach, 2, 10 i 30 minutach. Odpowiedź 410 Gone zatrzymuje ponowienia.

Jak połączyć Webhooki

  1. Otwórz Alert channels na pasku bocznym i wybierz Add channel.

  2. Wybierz Webhook i wpisz Endpoint URL.

  3. Wybierz Add channel i skopiuj wyświetlony sekret podpisu. Jest pokazywany tylko raz.

  4. Wybierz Send test, aby wysłać zdarzenie testowe do swojego endpointu.

Wszystkie pola i wersja sprawdzenia w Pythonie są w dokumentacji API.

W każdym planie, także w planie Free.

Co przychodzi

monitor.down
Potwierdzona awaria
monitor.up
Powrót, z czasem przestoju
monitor.slow
Odpowiedzi powyżej Twojego limitu
monitor.fast
Znowu poniżej limitu
certificate.expiring
Certyfikat TLS wkrótce wygasa lub już wygasł
domain.expiring
Rejestracja domeny wkrótce wygasa lub już wygasła
dns.changed
Zmienione rekordy DNS, z wartością przed i po
server.rebooted
Serwer z agentem został zrestartowany
site.issues
Nowe uszkodzone linki lub mieszana zawartość
site.performance_dropped
Mobilny wynik szybkości strony spadł poniżej Twojego progu
domain.email_issues
Nowe problemy z konfiguracją poczty domeny
test
Wysłane przez Wyślij test

POST na Twój 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
}
Zdarzenie monitor.down. monitor.up zawiera ten sam identyfikator incydentu i czas przestoju w sekundach.

Pytania

Jak zweryfikować podpis?

Oblicz HMAC-SHA256 z wartości x-uptimecheck-timestamp, kropki i surowej treści żądania, z sekretem podpisu jako kluczem. Porównaj wynik w stałym czasie z wartością hex po sha256= w x-uptimecheck-signature i odrzucaj stare znaczniki czasu.

Jakie zdarzenia są wysyłane?

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

Co się dzieje, gdy mój endpoint nie działa?

Żądanie, które w ciągu 10 sekund nie otrzyma odpowiedzi 2xx, jest ponawiane jeszcze cztery razy: po 30 sekundach, 2 minutach, 10 minutach i 30 minutach. Potem kanał pokazuje status Not delivering z ostatnim błędem. Odpowiedź 410 Gone natychmiast zatrzymuje ponowienia.

Czy mogę ponownie zobaczyć sekret podpisu?

Nie. Jest pokazywany raz, przy dodawaniu kanału, i nigdy się nie zmienia. Aby mieć nowy sekret, dodaj nowy kanał webhook i usuń stary.

Czy subskrybenci naszej strony statusu mogą śledzić ją także tutaj?

Tak. Odwiedzający stronę statusu Uptimecheck mogą ją obserwować na Slacku, w Microsoft Teams, na Discordzie lub przez webhook, w całości albo tylko wybrane komponenty, i otrzymywać tam Twoje aktualizacje statusu.

Czy jest w każdym planie?

Tak. Każdy kanał alertów poza SMS jest dostępny w każdym planie, także w planie Free; SMS wymaga płatnego planu i korzysta z kredytów (wliczonych w planach Professional i Business, kupowanych w pakietach w planie Start). Plany różnią się liczbą kanałów alertów, które możesz dodać: 3 w Free, 25 w Start, 75 w Professional i 250 w Business.

Przestoje to przeszłość.

Skonfiguruj pierwszy monitor w niecałą minutę albo najpierw rozejrzyj się w demo na żywo.

14 dni za darmo · Potem 5 monitorów gratis · Bez karty kredytowej