BKV-Webhooks

​

Unterstützte Ereignisse

​

Payload-Format

{
  "event": "nomination.error_detected",
  "timestamp": "2026-01-14T18:25:00Z",
  "data": { ... }
}

​

Signaturverifizierung

1. Extrahieren Sie den Wert des X-Webhook-Signature-Headers aus der Anfrage.
2. Berechnen Sie den HMAC-SHA256 des Roh-Request-Bodys mit Ihrem gemeinsamen Geheimnis.
3. Vergleichen Sie die berechnete Signatur mit dem Header-Wert.

# Beispiel: Webhook-Signatur verifizieren
SIGNATURE=$(echo -n "$REQUEST_BODY" | openssl dgst -sha256 -hmac "$WEBHOOK_SECRET" | awk '{print $2}')

if [ "$SIGNATURE" = "$RECEIVED_SIGNATURE" ]; then
  echo "Gültige Signatur"
fi

​

Best Practices

• Schnell antworten: Senden Sie innerhalb weniger Sekunden einen 200-Statuscode zurück. Verarbeiten Sie das Ereignis bei Bedarf asynchron.
• Duplikate behandeln: Ereignisse können mehrfach zugestellt werden. Verwenden Sie timestamp und Ereignisdaten zur Deduplizierung.
• Fehler überwachen: Wenn Ihr Endpunkt nicht antwortet, wiederholt Otark die Zustellung mit exponentiellem Backoff.