Websitemonitoring via webhooks
Uptimia controleert uw sites, certificaten en afrekenflows van buiten uw netwerk en roept uw endpoint aan bij elke bevestigde storing. Uw eigen code bepaalt wat er daarna gebeurt — een ticket openen, een service herstarten, een dashboard voeden — en elke controle stuurt hetzelfde formaat, zodat u de handler maar één keer hoeft te schrijven.
Authorization: Bearer •••••••••••••••• Content-Type: application/json { "id": 3517, "monitor_type": "uptime", "monitor_name": "Checkout — caldmont.com", "monitor_unique_id": "checkout-prod", "monitor_status": "down", "severity": "critical", "incident_start_time": "2026-07-30T11:47:12+02:00", "incident_end_time": "", "incident_duration_seconds": 0, "message": "*ALERT*: Project Checkout — caldmont.com is DOWN", "monitor_notes": "Failover: drain eu-west-2 first" }
Geen bericht, een contract
Elk ander kanaal komt uiteindelijk bij een mens terecht, en mensen zijn coulante lezers. Code is dat niet — daarom zit het interessante nooit in de payload, maar in de garanties erachter.
“Er ging iets stuk” — de rest zoekt u zelf uit
Bewoordingen kunnen tussen releases verschuiven, omdat de lezer zich aanpast. Zodra software ervan afhankelijk is, wordt die vrijblijvendheid een fout in uw integratie.
Elf velden, vijf pogingen, één structuur
Eén object voor elk type controle: schrijf één handler, vertak op twee velden. Er wordt tot vijf keer opnieuw geprobeerd voordat het wordt losgelaten, dus duplicaten zijn mogelijk — gedocumenteerd in plaats van bij toeval ontdekt.
De waarschuwing komt binnen in uw eigen code
Een controle faalt en Uptimia roept uw endpoint aan met de details, al bevestigd. Uw eigen automatisering bepaalt wat er daarna gebeurt — hier, een ticket dat zichzelf opent en sluit bij herstel.
Een webhook koppelen in drie stappen
Geen app om te autoriseren en geen library om te installeren — Uptimia heeft alleen een URL nodig om aan te roepen en, als het endpoint beveiligd is, een header die er toegang toe geeft.
Plak de URL van uw endpoint
Dat is de hele registratie — één publieke URL.
Voeg uw auth-headers toe
Optioneel — headers worden exact verstuurd zoals u ze schrijft, zodat een token Uptimia door uw eigen deur laat.
Wijs uw monitors ernaar
Kies de controles die het moeten aanroepen, en een testbezorging bewijst de koppeling met het echte formaat.
Een webhook-endpoint registreren
Het Helpcentrum behandelt de implementatie: de URL toevoegen, de aangepaste headers schrijven, een test-POST versturen, en begrijpen wat een mislukte bezorging u vertelt.
Elk type controle. Eén structuur.
Een verlopend certificaat, een cronjob die zich nooit meldde en een server boven zijn CPU-drempelwaarde komen allemaal binnen als hetzelfde platte object. Twee velden maken het verschil.
Chatbruggen, databaserijen, geautomatiseerde acties
Zodra een incident een object is dat uw code heeft geaccepteerd, gaan de nuttige toepassingen niet meer op waarschuwen lijken.
Andere kanalen vertellen het aan een mens.Deze vertelt het aan uw code.
Het hele platform tijdens de proefperiode — elk type controle, 171+ probes, en elk bevestigd incident bezorgd als een object dat van u is.
De bezorggaranties, zwart-op-wit
Niemand kan een betrouwbare handler schrijven op basis van “we sturen u een melding”. Dit zijn de daadwerkelijke garanties.
At-least-once, met vijf pogingen
Tien seconden om te antwoorden, en elke 2xx telt als geaccepteerd. Al het andere wordt opnieuw in de wachtrij gezet en tot vijf keer opnieuw geprobeerd, telkens met een minuut langer wachttijd, en daarna verwijderd — dus antwoord eerst en doe het werk daarna.
Eén plat object, elf sleutels
Geen nesting, geen envelope, geen schema dat verandert met het type controle. Twee velden maken het verschil; de andere negen veranderen nooit van betekenis — inclusief monitor_notes, de runbookregel die degene die de monitor instelde, heeft achtergelaten.
Een storm voegt een sleutel toe
Monitors die samen uitvallen worden één request met een extra group-object — leden, aantallen, bevestiging. Handlers die dit negeren, blijven gewoon werken.
Uw headers, doorgegeven
Letterlijk doorgestuurd, zodat een bearer token of shared secret werkt. Er is geen handtekening over de body — controleer de header serverzijdig, en houd de URL geheim.
Waar het weigert te posten
Alleen publieke http(s); loopback- en privéreeksen worden geweigerd. Het adres wordt één keer opgelost en vastgezet, redirects worden genegeerd, TLS geverifieerd.
Geen bevestigingslink — met opzet
Kanalen die een mens leest, bevatten een ondertekende link die de escalatieketen stopzet. Machines krijgen de feiten en verder niets — een logpipeline die een pager kan stilzetten, doet dat uiteindelijk ook.
Hoe monitoringwebhooks werken
Uptimia controleert uw websites vanaf 171+ externe locaties en stuurt, zodra een controle faalt, een HTTP POST met een JSON-body naar elke URL die u registreert. Voor elk type controle komt hetzelfde platte object binnen — welke monitor, wat er gebeurde, wanneer, en hoe lang — zodat één handler ze allemaal afdekt, en mislukte bezorgingen opnieuw worden geprobeerd.
De bug die iedereen op dag één schrijft
Herstel, waarschuwingen en tests delen één endpoint. monitor_status is down, up of test; severity is critical of trouble, en leeg bij herstel. Vertak op beide.
Bevestigd voordat uw code het hoort
Automatisering is nooit betrouwbaarder dan de trigger erachter. Een webcontrole wordt nooit gemeld op basis van de mening van één probe — een vermoedelijke storing wordt eerst vanaf andere probes opnieuw getest.
Elf velden, elke gebeurtenis
Wat er altijd aanwezig is, en wat het bevat.
Bekijk alle waarschuwingskanalen →| Veld | Voorbeeld | Wat het bevat |
|---|---|---|
| id | 4172 | Het numerieke ID van de monitor binnen Uptimia |
| monitor_type | uptime | Welk type controle afging |
| monitor_name | Dispatch API | De naam die u eraan gaf (sitenaam bij uptime-controles) |
| monitor_unique_id | dispatch-api-eu | Uw eigen identificatie — de sleutel om op te koppelen |
| monitor_status | down | down, up of test |
| severity | critical | critical of trouble — leeg bij herstel |
| incident_start_time | 2026-07-24T02:17:04+02:00 | ISO 8601, tijdzone van het account |
| incident_end_time | 2026-07-24T02:31:07+02:00 | Leeg zolang het incident open staat |
| incident_duration_seconds | 843 | Nul totdat het incident wordt gesloten |
| message | *ALERT*: Project … is DOWN | De eenregelige samenvatting die andere kanalen ontvangen |
| monitor_notes | Failover: drain eu-west-2 first | De notitie bij de monitor — leeg als niemand er een schreef |
Veelgestelde vragen over aangepaste webhooks
01Wat verstuurt Uptimia precies?+
02Hoe authenticeer ik het request?+
03Wat gebeurt er als mijn endpoint traag of offline is?+
04Kan ik dezelfde gebeurtenis ooit twee keer ontvangen?+
05Kan ik hem naar localhost of een intern adres wijzen?+
06Volgt Uptimia redirects?+
07Wat komt er binnen als meerdere monitors tegelijk uitvallen?+
08Kan mijn handler bevestigen of antwoorden?+
09Wat post “Test versturen” precies?+
10Hoeveel endpoints kan ik hebben, en is dit inbegrepen?+
Eén URL, elk bevestigd incident
Registreer een endpoint, koppel het aan de monitors die ertoe doen, en elke bevestigde storing komt binnen als een object waarmee uw systemen kunnen archiveren en handelen.