Webhooks

Webhooks die geen events laten vallen

HMAC-SHA256-ondertekende payloads, retries met exponential backoff, replay-vanaf-elk-moment en een test-fire-knop op elk endpoint.

Webhooks configureren Bekijk de spec

8 event-typen

Abonneer op wat ertoe doet

Elk endpoint kan opt-in op één of meerdere events. Payload-schemas zijn versioned en gedocumenteerd in OpenAPI.

site.created

Nieuwe site geprovisioneerd

site.provisioned

Provisioning voltooid

site.suspended

Site automatisch opgeschort

site.cancelled

Klant heeft opgezegd

plugin.installed

Plugin gekoppeld aan een site

plugin.uninstalled

Plugin ontkoppeld

invoice.issued

Nieuwe factuur gegenereerd

invoice.paid

Factuur betaald

Ondertekende payloads

Elk request bevat een X-RadCMS-Signature-header die je kunt verifiëren tegen het signing secret van je endpoint. Wijs elk request af dat de verificatie niet doorstaat — zo voorkom je vervalsing.

HMAC-SHA256 over de ruwe request body.
Signing secret wordt eenmalig bij aanmaken getoond, nooit meer.
Rotatie ondersteund — oude + nieuwe keys gelden beide 7 dagen lang.
Replay-bescherming via X-RadCMS-Timestamp + een venster van 5 minuten.

// PHP — verifieer een radcms-webhook
$secret    = env('RADCMS_WEBHOOK_SECRET');
$payload   = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_RADCMS_SIGNATURE'];

$expected = 'sha256=' .
  hash_hmac('sha256', $payload, $secret);

if (! hash_equals($expected, $signature)) {
  http_response_code(401);
  exit('Invalid signature');
}

$event = json_decode($payload, true);
// verwerk $event …

Gebouwd om jouw downtime te overleven

Een slechte dag van jouw endpoint mag geen events kosten. Zo gaan we ermee om.

Exponential backoff

Retries op 1s, 10s, 1m, 10m, 1u, 1d. Na 6 mislukte pogingen wordt het endpoint automatisch opgeschort tot een operator actie onderneemt.

Replay vanaf elk moment

Elke delivery wordt gelogd met volledige payload + response. Replay individuele events of een datumbereik met één klik vanuit het dashboard.

Test per endpoint

Klik de Test-knop in het dashboard om een voorbeeld-payload naar je endpoint te sturen. Bekijk responsecode, body en timing inline.

Live delivery log

Laatste 7 dagen aan deliveries per endpoint, met HTTP-code, latentie en het volledige request/response.

Auto-uitschakelen na N mislukkingen

6 opeenvolgende mislukkingen pauzeert het endpoint en mailt je team. Heractiveer vanuit het dashboard zodra je het hebt gefixt.

IP-allowlist (Enterprise)

Al het uitgaande webhook-verkeer van radcms komt van een gedocumenteerde set IP-adressen. Enterprise-klanten kunnen een strengere allowlist instellen.

Klaar om je stack aan te sluiten?

Maak een account aan en voeg je eerste endpoint toe in minder dan een minuut.

Beginnen — het is gratis