Webhooks

Optioneel. Wij POST-en naar jouw https-adres als er iets gebeurt. Je maakt de webhook onder Instellingen. Het geheim zie je één keer. Maximaal 5 webhooks per account.

Gebeurtenissen

In deze versie:

• inzicht.klaar — een waardering of invloeden-call is gelukt
• inzicht.mislukt — een aanroep is mislukt
• saldo.laag — onder de 200 credits (€10)
• saldo.op — tegoed is 0
• webhook.test — het testbericht van de knop, niet om op te abonneren

Adres, WOZ en label vuren inzicht.klaar niet. Waarde en invloeden wel.

Headers

Elke aflevering draagt vier headers:

• X-Percelio-Event
• X-Percelio-Timestamp
• X-Percelio-Delivery
• X-Percelio-Signature — HMAC-SHA256 over de ruwe body, met het geheim als sleutel, hexadecimaal

De handtekening controleren

$body = file_get_contents('php://input');
$eigen = hash_hmac('sha256', $body, $geheim);
if (! hash_equals($eigen, $_SERVER['HTTP_X_PERCELIO_SIGNATURE'])) {
    http_response_code(401);
    exit;
}

Teken de ruwe body, niet een opnieuw gecodeerde JSON. Weiger een bericht waarvan verzonden_op ouder is dan vijf minuten. Hetzelfde X-Percelio-Delivery is hetzelfde bericht: verwerk het één keer.