Le integrazioni webhook richiedono regole per le ripetizioni

Nel progettare un’integrazione webhook, le consegne ripetute vanno considerate una possibile condizione operativa. La scelta del software deve affrontare ciò che accade all’azione aziendale quando il messaggio arriva una seconda volta. Una connessione affidabile non risponde da sola a questa domanda.

Un segnale perso lascia l’esito incerto

In un portale clienti fittizio una notifica avvia la creazione di un ordine nell’ERP. L’ordine viene creato, ma la risposta non raggiunge il mittente. Questi invia nuovamente la notifica. Se ogni arrivo crea ciecamente un nuovo ordine, la stessa azione voluta produce due ordini.

Stripe segnala esplicitamente che gli eventi possono essere consegnati più volte. Questo documenta un caso specifico di un fornitore. Deve esaminare il contratto della Sua connessione per determinare quali ripetizioni possa generare. Da una conferma di ricezione mancante non si può dedurre né un successo certo né un fallimento certo.

Valutare la ripetizione in base all’effetto sul business

Nell’esempio, la regola desiderata consente alla stessa notifica di ritrovare l’ordine già creato invece di crearne un altro. L’integrazione richiede un’identità concordata e un’associazione affidabile con il risultato dell’elaborazione. La protezione deve considerare anche due copie che arrivano contemporaneamente; controllare e salvare in seguito, in passaggi indipendenti, lascia aperta questa questione.

Nello scenario di accettazione verifichi l’ordine nell’ERP, la risposta al nuovo tentativo e lo stato visibile nel portale. Una conferma del trasporto e un ordine completato possono rappresentare stati diversi.

L’impegno dipende dall’azione

Se una notifica si limita a impostare nuovamente un valore visualizzato già identico, la ripetizione può essere innocua. La creazione di un ordine o un altro effetto voluto una sola volta richiede più protezione. Questo non impone di aggiungere una coda a ogni piccola connessione.

Le ripetizioni devono restare visibili. Un aumento può segnalare un guasto. Raccomandiamo di gestire le ripetizioni prevedibili conservando anche la possibilità di indagare sugli andamenti insoliti.

Fonti

• Stripe: Webhooks, duplicate events