Storingsdata in je eigen systemen

Een bericht zodra er iets verandert bij de bedrijven die je volgt. Tot vijf koppelingen per account, in te stellen in het portaal onder API: naar je eigen adres (een POST met JSON), of naar een kanaal in Slack of Teams. Per koppeling kies je de bedrijven en de events. Met de demodienst voorbeeld werkt het ook op het gratis plan.

Tussen geen meldingen en rustig gaat niets: dat is geen storing en geen herstel.

{ "id": "evt_9Kq2...",
  "type": "storing.begonnen",
  "aangemaakt": "2026-10-19T14:05:00.000Z",
  "data": {
    "bedrijf": "kpn", "naam": "KPN",
    "status": "storing", "vorige_status": "rustig",
    "meldingen_laatste_uur": 63, "factor": 9.4,
    "storing_id": "5b0c...", "url": "https://storingenoverzicht.nl/storing/kpn" } }

Elke POST naar je eigen adres draagt X-Storingen-Handtekening: t=1792406700,v1=…. v1 is de HMAC-SHA256 van de tijd, een punt en de ruwe inhoud, met het geheim van de koppeling. Weiger alles ouder dan vijf minuten. Het geheim zie je één keer, bij het maken of vernieuwen.

import { createHmac, timingSafeEqual } from 'node:crypto'

// kop: de waarde van X-Storingen-Handtekening, lichaam: de ruwe tekst
function echt(kop, lichaam, geheim) {
  const { t, v1 } = Object.fromEntries(kop.split(',').map((d) => d.split('=')))
  if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false
  const goed = createHmac('sha256', geheim).update(`${t}.${lichaam}`).digest('hex')
  return timingSafeEqual(Buffer.from(goed), Buffer.from(v1 ?? ''))
}

Antwoord binnen 10 seconden met een 2xx. Anders proberen we het opnieuw na 1, 5, 30 en 120 minuten. In het portaal staat per koppeling een afleverlog van 7 dagen, en een knop voor een testbericht.

Alleen geslaagde verzoeken tellen. Alle sleutels van één account delen de limiet.

{ "fout": { "code": "limiet_bereikt",
            "bericht": "Limiet van 1.000 verzoeken per dag bereikt.",
            "documentatie": "https://storingenoverzicht.nl/api#limieten" } }