L’header svix-id
Ogni richiesta webhook include un headersvix-id. Questo ID è:
- Unico per messaggio — Ogni evento distinto riceve un ID univoco
- Coerente tra i tentativi — Lo stesso ID viene utilizzato quando si ritenta una consegna fallita
Implementare la deduplicazione
Per assicurarti di elaborare ogni evento una sola volta, memorizza losvix-id e controllalo prima di procedere:
Quando usare la deduplicazione
La deduplicazione è particolarmente importante per:- Elaborazione dei pagamenti — Evita di addebitare due volte i clienti
- Creazione degli ordini — Previene ordini duplicati
- Aggiornamenti dell’inventario — Garantisce conteggi delle scorte accurati
- Invio di notifiche — Non inviare messaggi duplicati agli utenti
Opzioni di archiviazione
Puoi memorizzare gli ID dei webhook elaborati in:Anche senza deduplicazione, progettare i tuoi handler webhook affinché siano idempotenti (producano lo stesso risultato se chiamati più volte) è una buona pratica.