Webhook

Webhook, einfach erklärt

Bei einer API fragt Ihr Programm an. Bei einem Webhook läuft es umgekehrt: Das fremde System meldet sich von selbst. Sie hinterlegen dort eine Adresse (URL). Tritt ein Ereignis ein, etwa eine neue Anfrage oder eine bezahlte Rechnung, sendet das System eine kurze Nachricht mit den Eckdaten an diese Adresse. Das Ergebnis ist eine Art automatische Benachrichtigung zwischen zwei Programmen.

Ein Vergleich: Eine API-Abfrage entspricht dem Blick in den Briefkasten, ein Webhook der Türklingel. Man muss nicht regelmäßig nachfragen, ob etwas passiert ist. Das empfangende Programm ist dafür eine kleine Anwendung, die unter der hinterlegten Adresse erreichbar sein muss.

Ein allgemeines Beispiel: Ein Formular auf einer Website löst beim Absenden einen Webhook aus. Die empfangende Adresse legt den Eintrag in einer Liste an und schickt dem Betrieb einen Hinweis. Auch Zahlungsdienste und Terminbuchungen melden Ereignisse häufig auf diese Weise. Nicht jedes System bietet Webhooks an. Dann bleibt die regelmäßige Abfrage über die API.

Worauf es ankommt: Die Adresse ist öffentlich erreichbar, deshalb muss das empfangende Programm prüfen, ob eine Nachricht echt ist, zum Beispiel über eine Signatur oder ein gemeinsames Geheimnis. Webhooks können doppelt, verspätet oder gar nicht eintreffen. Sinnvoll ist deshalb oft zusätzlich ein geplanter Abgleich, der Verpasstes nachholt. Wichtig ist auch, die Nachricht schnell zu bestätigen und die eigentliche Arbeit danach zu erledigen, damit der Absender nicht auf eine Antwort wartet und es erneut versucht.