Mit einem Webhook sendet Xendy automatisch eine POST-Anfrage an deine URL, wenn etwas passiert. Du wählst aus drei Events:
- DNS-Einträge nicht mehr korrekt (
dns-records.failed)
- DNS-Einträge wiederhergestellt (
dns-records.recovered)
- Webshop-Import fehlgeschlagen (
webshop-import.failed)
- Klicke im Tab Webhooks auf Webhook hinzufügen.
- Gib die URL ein (nur https) und wähle die Events.
- Klicke auf Hinzufügen. Kopiere das Webhook-Secret, das erscheint: du siehst es nur einmal.
Jede Nachricht ist JSON mit id, event, created_at und data und enthält die Header Xendy-Event, Xendy-Delivery und Xendy-Signature. Mit der Signatur überprüfst du, dass die Nachricht wirklich von Xendy stammt. Xendy-Signature hat die Form t=<Zeitpunkt>,v1=<Signatur>: Die Signatur ist ein HMAC-SHA256 von <t>.<body> mit deinem Secret. Weise Nachrichten ab, bei denen t älter als 5 Minuten ist. Ein Beispiel in JavaScript findest du in der Dokumentation.
Antworte innerhalb von 10 Sekunden mit einem 2xx-Statuscode. Gelingt die Zustellung nicht, versucht Xendy es nach 1, 5 und 30 Minuten erneut. Schlagen fünf Events nacheinander vollständig fehl, setzt Xendy den Webhook auf Deaktiviert. Jeden Versuch siehst du im Tab Aktivität unter Ausgehender Webhook.