API-webhooks instellen

API-webhooks instellen

Met API-webhooks ontvang je automatisch een HTTP POST-request wanneer er nieuwe meldingen binnenkomen of wanneer voertuigen of capcodes worden gewijzigd.

Beschikbare events

Webhook aanmaken via de website

1. Ga naar Instellingen → API
2. Scroll naar het Webhooks gedeelte
3. Klik op Webhook toevoegen
4. Vul de URL in waarnaar de notificaties moeten worden gestuurd
5. Selecteer de events waarvoor je notificaties wilt ontvangen
6. Klik op Opslaan
7. Noteer het webhook-secret dat wordt getoond — dit heb je nodig om de handtekening te verifiëren

Webhook aanmaken via de API

Je kunt webhooks ook programmatisch beheren via de API:

curl -X POST https://meldingsmonitor.test/api/v1/webhooks \
  -H "Authorization: Bearer jouw-api-token" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://jouw-server.nl/webhook",
    "events": ["incident.created", "incident.updated"]
  }'

Webhook payload

Bij elk event ontvang je een JSON-payload:

{
  "event": "incident.created",
  "data": {
    "id": 12345,
    "occurred_at": "2026-02-13T10:30:00+00:00",
    "message": "P 1 BRT-01 Brandmelding industrie Hoofdstraat 1 Gemeente",
    "priority": "1",
    "city": "Amsterdam",
    "latitude": 52.3676,
    "longitude": 4.9041
  },
  "timestamp": "2026-02-13T10:30:05+00:00"
}

Handtekening verifiëren

Elke webhook bevat een X-Webhook-Signature header met een HMAC-SHA256 handtekening. Verifieer deze met je webhook-secret:

$signature = hash_hmac('sha256', $requestBody, $webhookSecret);
$isValid = hash_equals($signature, $receivedSignature);

Foutafhandeling en retries

• Als je server een niet-2xx statuscode teruggeeft, wordt het verzoek opnieuw geprobeerd
• Retries gebeuren met backoff (10s, 60s, 300s)
• Na 10 opeenvolgende mislukte leveringen wordt de webhook automatisch gedeactiveerd
• Je kunt een gedeactiveerde webhook weer activeren via Instellingen → API

E-mail bij automatische deactivatie

Wanneer een webhook-endpoint automatisch wordt gedeactiveerd na opeenvolgende mislukte leveringen, ontvang je standaard een e-mail op het adres van je account. Daarin staan het betreffende endpoint, het aantal mislukte pogingen en een link naar je API-instellingen.

Zo hoef je niet continu te controleren of je webhooks nog actief zijn — je krijgt een seintje zodra MeldingsMonitor stopt met leveren aan een endpoint.

Voorkeur beheren:

1. Ga naar Instellingen → API
2. Scroll naar het Webhooks-gedeelte
3. Vink E-mail bij gedeactiveerde webhook aan of uit

Deze e-mail wordt alleen verstuurd bij automatische deactivatie (na 10 mislukte pogingen). Als je een webhook zelf deactiveert via het dashboard, ontvang je geen e-mail.

Limieten

Het aantal webhook-endpoints dat je kunt aanmaken hangt af van je abonnement: