Was ist ein Webhook?
Ein Webhook ist eine HTTP-Anfrage, mit der ein System ein anderes über ein eingetretenes Ereignis benachrichtigt. Zuverlässige Implementierungen prüfen Signaturen, tolerieren Wiederholungsversuche und verarbeiten doppelte Zustellungen idempotent.
So funktionieren Webhooks
Ein Webhook-Erzeuger serialisiert ein Ereignis und sendet es an einen HTTP-Endpunkt unter Kontrolle des Empfängers. So werden asynchrone Zustandsänderungen vom Polling entkoppelt. Die Zustellung erfolgt normalerweise mindestens einmal statt genau einmal, da der Sender bei einer verlorenen Antwort nicht wissen kann, ob die Verarbeitung erfolgreich war. Der Empfänger authentifiziert daher die ursprüngliche Anfrage, erfasst eine Ereigniskennung, bestätigt den Empfang zügig und verlagert aufwendige Medienverarbeitung oder Geschäftslogik in eine dauerhafte Warteschlange.
Wichtige Fakten
- Anbieter legen genau fest, was signiert wird: Einige signieren die unveränderten Anfragebytes samt Zeitstempel, während Transloadit eine Benachrichtigung (
application/x-www-form-urlencoded) sendet, deren Feldsignatureeinen hexadezimalen HMAC-SHA1-Wert in Kleinbuchstaben enthält, berechnet aus der exakten Zeichenfolge im Feldtransloadit. Wählen Sie die Geheimschlüssel zur Verifizierung aus einer vertrauenswürdigen serverseitigen Konfiguration für die erwartete Assembly und den erwarteten Workspace, da eine erneut gesendete Benachrichtigung mit einem anderen gültigen Schlüssel signiert sein kann; die Vorgaben zur Webhook-Verifizierung enthalten die vollständigen Regeln. Verifizieren Sie die vom Anbieter definierte Nutzlast, niemals eine erneut serialisierte Fassung davon. - Wenn eine Erfolgsantwort erst nach langwieriger nachgelagerter Verarbeitung zurückgegeben wird, nehmen Zeitüberschreitungen und Wiederholungsversuche zu; wird das Ereignis vor der Empfangsbestätigung dauerhaft gespeichert, kann die Verarbeitung asynchron fortgesetzt werden.
- Wiederholungsversuche können Ereignisse duplizieren oder ihre Reihenfolge ändern. Deshalb schützen die Ereigniskennung und die aktuelle Ressourcenversion zuverlässiger vor unerwünschten Nebeneffekten als die Annahme, dass jeder Endpunktaufruf einmalig ist.
Wann Webhooks wichtig sind
Webhooks können die Anwendungslogik fortsetzen, wenn eine asynchrone Medienverarbeitung abgeschlossen ist oder fehlschlägt. Empfänger müssen Anfragen authentifizieren und wiederholte Nebeneffekte vermeiden, wenn der Sender die Zustellung eines Ereignisses erneut versucht.