Con un webhook, Xendy invia automaticamente una richiesta POST al tuo URL quando accade qualcosa. Puoi scegliere tra tre eventi:
- Record DNS non più corretti (
dns-records.failed)
- Record DNS ripristinati (
dns-records.recovered)
- Importazione negozio online fallita (
webshop-import.failed)
- Nella scheda Webhook clicca su Aggiungi webhook.
- Inserisci l'URL (solo https) e scegli gli Eventi.
- Clicca su Aggiungi. Copia il secret del webhook che appare: lo vedi una sola volta.
Ogni messaggio è in JSON con id, event, created_at e data, e include gli header Xendy-Event, Xendy-Delivery e Xendy-Signature. Con la firma verifichi che il messaggio provenga davvero da Xendy. Xendy-Signature ha la forma t=<timestamp>,v1=<firma>: la firma è un HMAC-SHA256 di <t>.<body> con il tuo secret. Rifiuta i messaggi il cui t è più vecchio di 5 minuti. Un esempio in JavaScript è disponibile nella documentazione.
Rispondi entro 10 secondi con un codice di stato 2xx. Se la consegna non riesce, Xendy riprova dopo 1, 5 e 30 minuti. Se cinque eventi consecutivi falliscono completamente, Xendy imposta il webhook su Disabilitato. Ogni tentativo è visibile nella scheda Attività, sotto Webhook in uscita.