Was bedeutet Webhook?
Statt regelmäßig nach neuen Daten zu fragen, informiert ein Webhook den Empfänger unmittelbar über ein Ereignis, etwa eine bestätigte Zahlung oder einen neuen Termin. Die Nachricht enthält typischerweise eine Ereignis-ID, einen Typ, einen Zeitpunkt und die für die Weiterverarbeitung nötigen Daten oder Referenzen.
Der Empfänger muss Herkunft und Unversehrtheit nach dem Verfahren des sendenden Dienstes prüfen. Zeitstempel, eindeutige Ereignis-IDs und eine begrenzte Gültigkeit helfen gegen wiederholte Zustellungen. Weil Sender bei Zeitüberschreitung häufig erneut senden, sollte die Annahme schnell bestätigt und die eigentliche Arbeit zuverlässig nachgelagert werden.
Ein Beispiel aus dem Betrieb
Ein Zahlungsanbieter meldet eine erfolgreiche Zahlung. Der Endpunkt prüft Signatur, Zeitfenster und Ereignis-ID, speichert die Annahme und bestätigt sie. Erst danach aktualisiert ein Hintergrundprozess den Auftrag. Eine wiederholte Nachricht mit derselben ID verändert den Auftrag nicht erneut.
Worauf Sie achten sollten
- Signatur und Zeitfenster werden nach der offiziellen Anbieter-Dokumentation geprüft.
- Ereignis-IDs verhindern doppelte fachliche Wirkungen.
- Die Annahme antwortet schnell; längere Verarbeitung läuft entkoppelt.
- Fehlgeschlagene Zustellungen, Wiederholungen und manuelle Nacharbeit sind sichtbar.
Wo die Grenzen liegen
HTTPS schützt die Transportverbindung, beweist aber allein nicht, welcher Dienst die Nachricht erzeugt hat. Eine anbieterbezogene Signaturprüfung und sichere Geheimnisverwaltung bleiben erforderlich.
Verwandte Begriffe
-
API-Integration
Eine API-Integration verbindet zwei Systeme über eine dokumentierte technische Schnittstelle und festgelegte Daten- und Fehlerverträge.
-
Idempotenz
Idempotenz bedeutet, dass dieselbe fachliche Operation mehrfach angefordert werden kann, ohne ihre beabsichtigte Wirkung mehrfach auszulösen.
-
n8n
n8n ist ein Werkzeug zur Workflow-Automatisierung: Ein Auslöser startet einen Ablauf, dessen Schritte Daten zwischen Programmen übertragen, prüfen und weiterverarbeiten – als Cloud-Dienst oder auf eigenem Server.
-
API (Programmierschnittstelle)
Eine API (Application Programming Interface, deutsch Programmierschnittstelle) legt fest, wie ein Programm Funktionen und Daten eines anderen Programms nutzen kann, ohne dessen Bedienoberfläche zu verwenden.
Passende Leitfäden und Leistungen
-
Programme über Schnittstellen verbinden
Webhooks, Datenfelder und Fehlerwege zwischen vorhandenen Programmen planen.
-
Lead-Automatisierung mit n8n
Anfragen kontrolliert erfassen, prüfen und an ein CRM übergeben.
