Webhook
Ein Webhook ist eine HTTP-Anfrage, die eine Anwendung automatisch an eine von Ihnen angegebene URL sendet, sobald ein bestimmtes Ereignis eintritt, etwa eine erfolgreiche Zahlung, sodass andere Systeme nahezu in Echtzeit von Änderungen erfahren, ohne wiederholt nachfragen zu müssen.
Was ist ein Webhook?
Er wird oft als Reverse API bezeichnet: Statt dass Ihr System nach Updates fragt, ruft das andere System Sie auf, wenn sich etwas ändert. Der Ablauf umfasst vier Schritte:
Sie registrieren einen HTTPS-Endpunkt und wählen Ereignistypen aus, etwa invoice.payment_failed bei Stripe oder orders/create bei Shopify.
Das Ereignis tritt im System des Anbieters ein.
Der Anbieter sendet eine POST-Anfrage mit einem JSON-Payload: Ereignistyp, Ereignis-ID, Zeitstempel und das betroffene Objekt.
Ihr Endpunkt antwortet schnell mit einem 2xx-Status; tut er das nicht, wiederholen die meisten Anbieter die Zustellung nach einem Backoff-Zeitplan.
Die Zustellung erfolgt meist nach dem Prinzip „at least once“, sodass dasselbe Ereignis zweimal ankommen kann, und Ereignisse können in falscher Reihenfolge eintreffen. Manche Anbieter senden nur eine Ereignis-ID und erwarten, dass Sie das vollständige Objekt über ihre API abrufen, was auch davor schützt, auf Basis veralteter Daten zu handeln.
Wie sichern und betreiben Sie einen zuverlässigen Endpunkt?
Behandeln Sie jeden eingehenden Aufruf als nicht vertrauenswürdig, bis seine Signatur verifiziert ist, und planen Sie vom ersten Tag an für Duplikate.
Signaturen verifizieren: Anbieter signieren den Roh-Body mit einem gemeinsamen Secret, typischerweise HMAC-SHA256, das in einem Header wie Stripe-Signature oder X-Shopify-Hmac-Sha256 mitgeschickt wird.
Veraltete Zeitstempel ablehnen, um Replays zu blockieren; die Bibliotheken von Stripe verwenden standardmäßig eine Toleranz von fünf Minuten.
Schnell bestätigen, später verarbeiten: Legen Sie das Ereignis in eine Queue wie Amazon SQS und geben Sie sofort 200 zurück.
Verarbeitung idempotent gestalten: Speichern Sie Ereignis-IDs und überspringen Sie bereits verarbeitete.
Abgleichen: Ein geplanter Job ruft aktuelle Datensätze über die API ab, um Verpasstes aufzufangen.
Wie sieht eine Webhook-Integration in der Praxis aus?
Eine typische Integration verwandelt ein Abrechnungsereignis innerhalb von Sekunden in Aktionen in mehreren Tools. Nehmen Sie einen Kochbox-Abo-Anbieter, der fehlgeschlagene Zahlungen bearbeiten will, bevor die nächste Lieferung gepackt wird.
Stripe sendet invoice.payment_failed an eine AWS-Lambda-Funktion hinter API Gateway.
Die Funktion verifiziert die Signatur, schreibt das Ereignis in SQS und gibt 200 zurück.
Ein Worker pausiert die nächste Box im Fulfillment-System, aktualisiert den Kundendatensatz in HubSpot und löst in Klaviyo eine E-Mail zur Aktualisierung der Zahlungsdaten aus.
Ein nächtlicher Job listet die fehlgeschlagenen Rechnungen des Tages über die Stripe-API auf und verarbeitet alle, die die Callbacks verpasst haben.
Angenommen, früher ging etwa einmal pro Woche eine Box an einen Kunden mit abgelehnter Karte raus; mit diesem Ablauf erfolgt die Pause, bevor das Packen beginnt.
Was sind die häufigsten Fallstricke bei Webhooks?
Die meisten Vorfälle entstehen aus der Annahme, dass jedes Ereignis genau einmal, in der richtigen Reihenfolge und bei laufendem Endpunkt ankommt. Typische Fehler:
Langsame Arbeit vor der Antwort zu erledigen, sodass der Anbieter in einen Timeout läuft, erneut sendet und Duplikate erzeugt.
Ereignisse während eines Ausfalls zu verpassen, der länger dauert als das Wiederholungsfenster des Anbieters.
Signaturprüfungen auszulassen, wodurch jeder, der die URL findet, gefälschte Ereignisse einschleusen kann.
Payload-Änderungen, wenn ein Anbieter eine neue API-Version veröffentlicht.
Für lokale Tests lassen sich mit der Stripe CLI, ngrok und webhook.site echte Payloads inspizieren. Polling ist die bessere Wahl, wenn ein Anbieter keine Ereignisse anbietet, wenn Sie eine vollständige Zustandssynchronisation brauchen oder wenn Daten nur einmal am Tag relevant sind.
Worin unterscheidet sich ein Webhook vom Polling einer API?
Polling fragt nach Zeitplan „Gibt es etwas Neues?“; Event-Callbacks pushen die Änderung in dem Moment, in dem sie passiert. Push ist schneller und schont API-Kontingente, während Polling einfacher nachzuvollziehen ist und nie eine Änderung verpasst, die bei der nächsten Abfrage noch vorhanden ist.
No-Code-Tools machen den Empfang von Ereignissen einfach: der Catch-Hook-Trigger von Zapier, der Webhook-Node von n8n und die Custom Triggers von Make. Für Teams, die Ereignisse an ihre eigenen Kunden senden, übernehmen Svix und Hookdeck Signierung, Wiederholungen und Zustellprotokolle. Diese Muster sind Teil von API-Integration, iPaaS-Plattformen und Echtzeit-Pipelines auf Basis von Streaming-Daten.
Webhooks vs. API-Polling
Webhooks (Push) | API-Polling (Pull) | |
|---|---|---|
Wer den Aufruf startet | Der Anbieter, wenn ein Ereignis eintritt | Ihr System, nach Zeitplan |
Latenz | Sekunden | Bis zum Polling-Intervall |
API-Kontingentnutzung | Gering | Hoch bei häufigem Polling |
Verpasste Änderungen | Bei Ausfällen möglich | Selten, wenn jede Abfrage den vollen Zustand liest |
Hauptaufwand | Signaturen, Wiederholungen, Idempotenz | Zeitplanung, Paginierung, Änderungserkennung |
Wie nutzt VIZIO AI ereignisgesteuerte Integrationen?
VIZIO AI baut Live-Datenverbindungen, damit Dashboards und Teams Änderungen ohne manuelles Aktualisieren sehen. Für ein Möbel- und Leuchtenunternehmen aus Minnesota setzte das DX Studio AWS-Lambda-Funktionen ein, um Live-Daten aus Shopify und internen Systemen zu verarbeiten, wobei Firebase die Authentifizierung und Echtzeit-Datenbankupdates für ein 4K-Operations-Dashboard übernahm.
Die Case Study gibt nicht an, ob Shopify-Ereignisse per Push oder per geplantem Abruf eintreffen; die Gemeinsamkeit liegt im serverlosen, ereignisverarbeitenden Design. Die Sichtbarkeit operativer Daten stieg um 85 % und die operative Effizienz um 21 %. So fangen Sie an: Listen Sie die drei Ereignisse in Ihrem Unternehmen auf, bei denen eine Verzögerung von Stunden Geld kostet, und prüfen Sie, ob jedes Quellsystem sie pushen kann.