Webentwicklung

Webhook — Ereignisbenachrichtigung

Ein Webhook ist eine Möglichkeit, eine Anwendung über ein Ereignis zu benachrichtigen, indem eine Anfrage an die angegebene Empfängeradresse gesendet wird. Beispielsweise kann das Zahlungssystem das Geschäft über eine Änderung des Transaktionsstatus informieren.

Veröffentlicht: Aktualisiert: 3 Min. Lesezeit
Schema: Webhook – Ereignisbenachrichtigung. Ereignis – Verifizierung – Wartung.

Was ist ein Webhook?

Ein Webhook ist eine Möglichkeit, eine Anwendung über ein Ereignis zu benachrichtigen, indem eine Anfrage an die angegebene Empfängeradresse gesendet wird. Beispielsweise kann das Zahlungssystem das Geschäft über eine Änderung des Transaktionsstatus informieren. Anstatt ständig jeden Datensatz abzufragen, reagiert der Empfänger auf das Signal der Quelle. Die Benachrichtigung kann vollständige Daten oder nur die ID enthalten, die zum Herunterladen über die API erforderlich ist. Das genaue Format und die Lieferregeln hängen von der Dokumentation des Lieferanten ab.

Empfang und Verifizierung

Die öffentliche Webhook-Adresse erfordert eine Überprüfung der Nachrichtenauthentizität, beispielsweise eine nach den Regeln des Anbieters berechnete Signatur. Ein geheimes URL-Fragment allein bietet nicht immer ausreichende Sicherheit. Überprüfen Sie die korrekten Anforderungsbytes, die richtige Zeit und den zulässigen Ereigniskontext. Vertrauen Sie keinem Preis oder Status, nur weil ein Feld den richtigen Namen hat. Halten Sie Geheimnisse aus dem öffentlichen Code fern und vermeiden Sie es, vollständige Kundendaten in Protokolle zu schreiben.

Duplikate und Bestellung

Die Quelle sendet möglicherweise ein Ereignis erneut, nachdem eine Bestätigung fehlt, auch wenn der Empfänger sie bereits verarbeitet hat. Verwenden Sie eine Ereignis-ID und eine idempotente Verarbeitung, um die Erstellung mehrerer Rechnungen oder wiederholter Lieferungen zu vermeiden. Da Nachrichten möglicherweise nicht in der richtigen Reihenfolge eingehen, sollte eine ältere Benachrichtigung eine neuere nicht rückgängig machen. Lesen Sie bei einem kritischen Vorgang den aktuellen Status der Quelle, anstatt jede eingehende Nachricht als endgültige Wahrheit zu betrachten.

Schnelle Bestätigung und Warteschlange

Speichern Sie das verifizierte Ereignis an einem dauerhaften Ort und erledigen Sie umfangreiche Arbeiten außerhalb der kurzen Empfangsanfrage. Die Bestätigung der Annahme sollte nicht bedeuten, dass alle weiteren Schritte abgeschlossen sind. Die Warteschlange benötigt eine Fehlerbehandlung, begrenzte Wiederholungsversuche und Platz für Nachrichten, die eine manuelle Analyse erfordern. Wenn Sie vor der endgültigen Speicherung den Empfang bestätigen, kann ein Prozessfehler dazu führen, dass die Veranstaltung ohne einen weiteren Versuch des Anbieters verloren geht.

Testen des gesamten Pfades

Prüfen Sie auf gültige Signatur, ungültige Signatur, Duplikat, Verzögerung, unbekannten Typ und fehlende Felder. Der Zahlungstest sollte den entsprechenden Bestellstatus bestätigen, nicht nur die HTTP-Antwort. Bestimmen Sie, was passiert, wenn der Empfänger nicht verfügbar ist, und wie Sie fehlende Vorgänge wiederherstellen können. Die Testumgebung sollte keine echten Dokumente oder Nachrichten an Clients senden. Das synthetische Ergebnis muss klar von der verifizierten Produktionsleistung unterschieden werden.

Statusüberwachung und -abgleich

Messen Sie Sammlungen, Bearbeitungszeiten und Rückstände. Die Warnung sollte den Prozess und die sichere Kennung angeben, ohne Geheimnisse preiszugeben. Ein regelmäßiger Vergleich mit der Quell-API hilft dabei, verpasste Änderungen zu erkennen. Während ein Webhook die Reaktion verbessert, stellt er selbst nicht sicher, dass eine Geschäftsaktion genau einmal ausgeführt wird. Zuverlässigkeit entsteht durch Überprüfung, dauerhaften Speicher, Deduplizierung und die Fähigkeit, eine kontrollierte Wiederherstellung durchzuführen, wenn ein Teil der Integration fehlschlägt.

Beispiel für eine erneute Zahlungsbenachrichtigung

Der Betreiber sendet ein Erfolgsereignis, die Anwendung speichert es, aber die Bestätigung kommt nicht zurück. Der Operator wiederholt die Nachricht. Der Empfänger sollte den Ausweis erkennen und die Ware oder Rechnung kein zweites Mal versenden. Wenn ein älterer Status später eintrifft, kann er den neueren Status nicht ohne Analyse rückgängig machen. Rufen Sie an einem kritischen Punkt den aktuellen Stand von einer autorisierten Quelle ab und wenden Sie die vereinbarten Übergangsregeln an.

Überprüfen Sie die Unterschrift anhand der Dokumentation, mit dem richtigen Anforderungstext und Schutz vor unerwünschter Reproduktion. Senden Sie nach der dauerhaften Annahme eine Bestätigung und übertragen Sie die harte Arbeit in eine kontrollierte Warteschlange. Erfassen Sie Fälle, die einen manuellen Eingriff und die Möglichkeit eines sicheren Wiederholens erfordern. Ein öffentlicher Endpunkt sollte keinen Status annehmen, nur weil der Absender den Namen des Feldes „transaction_id“ kennt.

Quellen und weiterführende Informationen

Anhand der Originaldokumentation können Sie die im Artikel beschriebenen Regeln und Grenzen überprüfen.

Wie entsteht unser Glossar?

Diese Artikel verbinden eigene redaktionelle Arbeit, KI-Unterstützung bei Redaktion und Übersetzung sowie die Prüfung anhand verlinkter Originaldokumentation. Beispiele dienen der Veranschaulichung, sofern nicht anders angegeben; sie stellen keine Kundenergebnisse dar. Die Daten beziehen sich auf die Veröffentlichung und tatsächliche Inhaltsänderungen.

Vom Wissen zur Umsetzung

Benötigen Sie Hilfe bei der Umsetzung?

Beschreiben Sie Ihre Website oder Ihren Prozess. Gemeinsam klären wir den Umfang und den nächsten praktischen Schritt.

Projekt besprechen