Met een webhook stuurt Xendy automatisch een POST-verzoek naar jouw URL als er iets gebeurt. Je kiest uit drie events:
- DNS-records niet meer correct (
dns-records.failed)
- DNS-records hersteld (
dns-records.recovered)
- Webshop-import mislukt (
webshop-import.failed)
- Klik op het tabblad Webhooks op Webhook toevoegen.
- Vul de URL in (alleen https) en kies de Events.
- Klik op Toevoegen. Kopieer het webhook-secret dat verschijnt: je ziet het maar één keer.
Elk bericht is JSON met id, event, created_at en data, en heeft de headers Xendy-Event, Xendy-Delivery en Xendy-Signature. Met de handtekening controleer je dat het bericht echt van Xendy komt. Xendy-Signature heeft de vorm t=<tijdstip>,v1=<handtekening>: de handtekening is een HMAC-SHA256 van <t>.<body> met jouw secret. Weiger berichten waarvan t ouder is dan 5 minuten. Een voorbeeld in JavaScript staat in de documentatie.
Antwoord binnen 10 seconden met een 2xx-statuscode. Lukt de bezorging niet, dan probeert Xendy het opnieuw na 1, 5 en 30 minuten. Mislukken vijf events achter elkaar helemaal, dan zet Xendy de webhook op Uitgeschakeld. Elke poging zie je terug op het tabblad Activiteit, onder Uitgaande webhook.