Zum Hauptinhalt springen
Webhook-Abonnements werden vom BKV-Portal-Administrator konfiguriert. Wenn aktiviert, sendet das System Echtzeit-Ereignisbenachrichtigungen an den registrierten Endpunkt.

​
Unterstützte Ereignisse

EreignisBeschreibung
day_ahead.file_createdEine neue Day-Ahead-Datei wurde erstellt
day_ahead.file_updatedEine bestehende Day-Ahead-Datei wurde aktualisiert
intraday.file_createdEine neue Intraday-Datei wurde erstellt
intraday.file_updatedEine bestehende Intraday-Datei wurde aktualisiert
gate_closure.time_reminderErinnerung, dass der Gate-Closure-Zeitpunkt naht (<8h verbleibend und Fehler vorhanden)
nomination.error_detectedEin Fehler wurde in einer Nominierung erkannt
contract.addedEin neuer Vertrag wurde hinzugefügt
customer.assignedEin neuer Kunde wurde dem BKV zugewiesen

​
Payload-Format

Alle Webhook-Payloads folgen dieser Struktur: 
{
  "event": "nomination.error_detected",
  "timestamp": "2026-01-14T18:25:00Z",
  "data": { ... }
}
Das Feld data enthält ereignisspezifische Details. Der timestamp ist der Zeitpunkt des Ereignisses (ISO 8601, UTC).

​
Signaturverifizierung

Payloads werden mit HMAC-SHA256 und einem gemeinsamen Geheimnis signiert. Die Signatur wird im X-Webhook-Signature-Header übermittelt. So verifizieren Sie ein Webhook-Payload:
  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
Verifizieren Sie immer die Webhook-Signatur, bevor Sie das Payload verarbeiten, um sicherzustellen, dass die Anfrage von Otark stammt.

​
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.