Webhooks
HTTP-Callbacks an Ihren Server, wenn sich der Status einer Zustellung ändert: kein Polling, Daten in Echtzeit.
Kernpunkte
- Prüfen Sie immer die HMAC-Signatur der eingehenden Anfragen: Sie garantiert, dass die Payload wirklich von NotifyHub stammt.
- Antworten Sie schnell mit 2xx und verarbeiten Sie die Payload asynchron: Langsame Antworten werden erneut versucht.
- Nutzen Sie das Register der Webhook-Zustellungen zum Debuggen: Es zeigt Payload, Antwort Ihres Servers und Wiederholungen.
Wozu diese Seite dient
Die Webhooks benachrichtigen Ihr System, wenn in NotifyHub etwas passiert, typischerweise bei Statusänderungen der Zustellungen (zugestellt, fehlgeschlagen ...). Sie registrieren die URL Ihres Servers und die Ereignisse, die Sie interessieren: Bei jedem Ereignis sendet NotifyHub eine signierte HTTP-Anfrage mit der vollständigen Payload.
So funktioniert es
Die Tabelle listet die Endpunkte mit URL, abonnierten Ereignissen, Status und letztem Trigger auf. Sie können einen Endpunkt mit dem Schalter aktivieren/deaktivieren (nützlich während der Wartung Ihres Servers) oder ihn löschen. Die Anfragen sind HMAC-signiert: Das Geheimnis für die Prüfung erhalten Sie bei der Erstellung des Endpunkts.
Zustellungen und Wiederholungen
Jeder Aufruf Ihres Endpunkts wird auf der Seite der Webhook-Zustellungen nachverfolgt, mit gesendeter Payload, Antwortcode und Anzahl der Versuche: Bei einem Fehler Ihres Servers versucht NotifyHub es automatisch erneut, und Sie können eine fehlgeschlagene Zustellung auch manuell erneut anstoßen. Bleibt Ihr Endpunkt längere Zeit ausgefallen, prüfen Sie das Register, um die verlorenen Ereignisse nachzuholen.