Webhook

Was ein Webhook ist

Ein Webhook ist eine automatische Meldung eines Systems an ein anderes, sobald ein Ereignis eintritt. Man kann ihn sich als Türklingel vorstellen: Statt regelmäßig nachzusehen, ob jemand vor der Tür steht, wird geklingelt. Technisch ist er ein Aufruf an eine Adresse, die der Empfänger bereitstellt, mit einer kurzen Nachricht über das Ereignis.

Wichtig ist die Richtung. Bei einer normalen Schnittstelle fragt der Empfänger beim Sender nach, in festen Abständen und ohne zu wissen, ob sich etwas geändert hat. Ein Webhook dreht das um: Der Sender meldet sich, und zwar dann, wenn es etwas zu melden gibt.

Warum das besser ist als Nachfragen

Der Abgleich in festen Abständen kostet immer. Er verbraucht Aufrufe, auch wenn nichts passiert ist, und er hat eine Verzögerung von bis zur halben Abfragezeit. Bei Beständen und Preisen ist eine Verzögerung von Minuten oft unproblematisch, bei einer Bestellung nicht.

Ein Webhook liefert dagegen unmittelbar und nur bei einem Ereignis. Für Bestellungen, Zahlungsbestätigungen und Versandstatus ist das der passende Weg, weil dort eine Verzögerung unmittelbar sichtbar wird, etwa wenn der Kunde die Bestellbestätigung vor dem Shop hat.

Was bei Ausfällen passieren muss

• Erneut zustellen: Der Sender muss eine Meldung wiederholen, wenn der Empfänger nicht erreichbar war. Ohne Wiederholung gehen Ereignisse verloren.
• Doppelt erkennen: Bei einer Wiederholung kann dieselbe Meldung zweimal ankommen. Der Empfänger braucht eine Kennung je Ereignis, um das zu erkennen.
• Schnell antworten: Der Empfänger sollte sofort bestätigen und die Verarbeitung danach erledigen. Wartet der Sender zu lange, bricht er ab.
• Nachweisbar sein: Eine Signatur im Aufruf zeigt, dass die Meldung vom erwarteten Absender stammt. Ohne sie kann jeder die Adresse aufrufen.
• Protokolliert werden: Ohne Aufzeichnung von Eingang und Ergebnis lässt sich ein Fehler später nicht nachvollziehen.

Wo er an Grenzen stößt

Der erste Punkt ist die Reihenfolge. Kommen zwei Meldungen kurz hintereinander, ist nicht garantiert, dass sie in derselben Reihenfolge verarbeitet werden. Wer sich darauf verlässt, baut Fehler ein, die selten und deshalb schwer zu finden sind.

Der zweite Punkt ist die Menge. Wer bei jeder kleinen Änderung eine Meldung sendet, erzeugt bei einem großen Sortiment eine Flut. Sinnvoll ist die Zusammenfassung, etwa eine Meldung mit mehreren Änderungen statt einer je Artikel. Der dritte Punkt ist die Abhängigkeit: Ein Webhook setzt voraus, dass der Empfänger erreichbar ist. Bei Arbeiten am eigenen System müssen Meldungen gepuffert und nachgeliefert werden können.

Häufige Fragen

• Ersetzt ein Webhook eine Schnittstelle? Nein, er ergänzt sie. Für Abfragen und Massenänderungen bleibt die Schnittstelle nötig.
• Kann ich einen Webhook testen? Ja, mit einer Adresse, die die Eingänge protokolliert.
• Was ist der häufigste Fehler? Keine Wiederholung beim Sender und keine Prüfung auf Doppelungen beim Empfänger.