Glossar
Was ist Webhook?
Kurz erklärt
Ein Webhook ist eine Benachrichtigung, die ein System per HTTP an eine hinterlegte Adresse sendet, sobald ein Ereignis eintritt. Das empfangende System muss nicht ständig nachfragen, sondern wird bei Neuigkeiten direkt angestoßen.
Wenn Programme Daten austauschen, gibt es zwei Grundmuster: aktiv nachfragen oder benachrichtigt werden. Der Webhook gehört zur zweiten Gruppe und ist ein verbreiteter Baustein bei automatisierten Abläufen.
Was ist ein Webhook?
Ein Webhook ist ein Aufruf, den ein Dienst selbstständig an eine vorher festgelegte Webadresse schickt, wenn etwas passiert. Der Aufruf enthält meist Angaben zum Ereignis in einem strukturierten Format wie JSON. Der Empfänger verarbeitet die Nachricht und bestätigt sie mit einem HTTP-Statuscode.
Webhooks gelten als Ergänzung zur klassischen API, nicht als Ersatz.
Worin unterscheidet sich ein Webhook von einer API-Abfrage?
Bei einer Abfrage fragt Ihr System regelmäßig bei einem anderen an, ob es Neues gibt. Bei einem Webhook meldet sich der andere Dienst von selbst. Das spart unnötige Anfragen und verkürzt die Wartezeit.
| Merkmal | API-Abfrage (Polling) | Webhook |
|---|---|---|
| Auslöser | Ihr System fragt an | Ereignis im Fremdsystem |
| Zeitpunkt | in festen Abständen | sofort bei Eintritt |
| Voraussetzung | Zugriff auf die Schnittstelle | erreichbare Empfangsadresse |
Welche Beispiele für Webhooks gibt es?
Zahlungsanbieter melden damit, dass eine Zahlung eingegangen ist, Entwicklungsplattformen melden neue Code-Änderungen, und Formular- oder Shopsysteme melden neue Bestellungen. In einem Workflow löst ein Webhook häufig den ersten Schritt aus, etwa das Anlegen eines Datensatzes oder das Versenden einer Bestätigung. Solche Verbindungen sind Teil der Prozessautomatisierung.
Worauf ist bei der Sicherheit zu achten?
Die Empfangsadresse ist öffentlich erreichbar, deshalb sollten eingehende Nachrichten geprüft werden. Üblich ist eine Signatur, die der Absender mitschickt und die der Empfänger mit einem gemeinsamen Geheimnis nachrechnet. Zusätzlich sollte der Empfänger doppelt gesendete Ereignisse verkraften und Fehler sauber melden. Wie sich Programme über Schnittstellen verbinden lassen, beschreibt die Seite zu Schnittstellen und Integrationen.