Webhook

Einfach erklärt

Ein Webhook ist eine automatische Benachrichtigung von Server zu Server – “Don’t call us, we’ll call you”. Statt ständig nachzufragen, sagt der Server dir Bescheid, sobald etwas passiert.

Polling vs. Webhook:

Polling:  App → "Neue Zahlung?" → Server → "Nein"
          App → "Neue Zahlung?" → Server → "Nein"
          App → "Neue Zahlung?" → Server → "Ja!" → Verarbeitung

Webhook:  (App wartet)
          Server → "Neue Zahlung!" → App → Verarbeitung

Typische Anwendungen: Zahlungsbenachrichtigungen (Stripe), CI/CD-Trigger (GitHub), Chat-Bots (Slack), KI-Workflow-Benachrichtigungen.

Technischer Deep Dive

Ablauf

1. Du registrierst eine Webhook-URL bei einem Service
2. Ein Ereignis tritt ein (z.B. Zahlung erfolgreich)
3. Der Service sendet einen HTTP POST an deine URL
4. Dein Server verarbeitet die Daten und antwortet mit 200 OK
5. Bei Fehler: Retry-Logik (exponentielles Backoff)

Sicherheit

• HMAC-Signatur: Payload wird mit einem Shared Secret signiert
• Timestamp-Validierung: Schutz vor Replay-Attacken
• HTTPS: Verschlüsselte Übertragung
• Idempotenz: Gleicher Webhook darf mehrfach verarbeitet werden ohne Seiteneffekte

Praxisbeispiel: Webhook-Handler in Node.js

app.post('/webhook/stripe', (req, res) => {
  const sig = req.headers['stripe-signature'];
  
  // Signatur verifizieren
  const event = stripe.webhooks.constructEvent(
    req.rawBody, sig, process.env.WEBHOOK_SECRET
  );
  
  // Event verarbeiten
  if (event.type === 'payment_intent.succeeded') {
    const payment = event.data.object;
    await fulfillOrder(payment.metadata.orderId);
  }
  
  res.json({ received: true }); // Schnell mit 200 antworten!
});

Webhooks in KI-Workflows

Webhooks sind ein Kernbaustein für Agentic Workflows und Event-driven AI:

• Async LLM-Jobs: Langer Inference-Job startet, Webhook benachrichtigt wenn fertig
• RAG-Pipelines: Neues Dokument hochgeladen → Webhook triggert Indexierung
• Model Monitoring: Drift erkannt → Webhook löst Alert oder Retraining aus
• CI/CD für ML: Code-Push → Webhook startet automatisches Modell-Training

Webhook vs. Polling vs. WebSocket

	Webhook	Polling	WebSocket
Richtung	Server → Client	Client → Server	Bidirektional
Latenz	Niedrig	Hoch	Sehr niedrig
Ressourcen	Effizient	Verschwenderisch	Verbindung offen
Ideal für	Seltene Events	Einfache Systeme	Echtzeit-Daten