🔔 Webhook-Integration

Erhalten Sie Echtzeit-Benachrichtigungen bei jedem wichtigen Event in Ihrem Supacheap.eu-Account. Kein Polling mehr – reagieren Sie sofort auf Löschanfragen, Statusänderungen und Compliance-Events.

Echtzeit
HMAC-signiert
Automatisches Retry
Sicherheit: Alle Webhook-Payloads werden mit einem HMAC-SHA256-Signature-Header (X-Supacheap-Signature) signiert. Prüfen Sie immer die Signatur, bevor Sie Events verarbeiten.

Verfügbare Event-Typen

Abonnieren Sie nur die Events, die Sie benötigen

EventBeschreibungAuslöser
deletion.initiatedLöschanfrage wurde erfolgreich erstelltPOST /deletion/requests
deletion.completedAlle Datensätze wurden gelöschtAutomatisch nach Abschluss
deletion.failedLöschvorgang fehlgeschlagenFehler während der Verarbeitung
certificate.issuedGDPR-Zertifikat wurde ausgestelltAutomatisch nach deletion.completed
quota.warningAPI-Kontingent zu 80% ausgeschöpftAutomatisch bei Schwellenwert
api_key.createdNeuer API-Key wurde erstelltPOST /auth/keys

Webhook-Empfänger implementieren

Beispielimplementierung für Ihren Server

// Node.js / Express — Webhook-Empfänger
const express = require('express');
const crypto  = require('crypto');
const app = express();

app.post('/webhook', express.raw({ type: 'application/json' }), (req, res) => {
  const sig       = req.headers['x-supacheap-signature'];
  const secret    = process.env.WEBHOOK_SECRET;
  const expected  = crypto
    .createHmac('sha256', secret)
    .update(req.body)
    .digest('hex');

  if (sig !== `sha256=${expected}`) {
    return res.status(401).send('Ungültige Signatur');
  }

  const event = JSON.parse(req.body);

  switch (event.type) {
    case 'deletion.completed':
      console.log('Löschung abgeschlossen:', event.data.requestId);
      break;
    case 'certificate.issued':
      console.log('Zertifikat URL:', event.data.certificateUrl);
      break;
  }

  res.json({ received: true });
});

app.listen(3000);

Retry-Logik

Automatische Wiederholung bei Fehlern mit exponential backoff.

  • Bis zu 5 Wiederholungsversuche
  • Exponential Backoff: 1s, 5s, 30s, 2min, 10min
  • Benachrichtigung bei endgültigem Fehlschlag

Delivery-Dashboard

Vollständige Übersicht aller Webhook-Zustellungen im Dashboard.

  • Zustellstatus für jeden Event einsehen
  • Payload und Response-Body inspizieren
  • Events manuell erneut senden

Webhooks aktivieren

Konfigurieren Sie Ihre Webhook-Endpoints im Developer-Dashboard und starten Sie sofort.