Rendere un job o un webhook ripetibile senza rischi
Prompt che protegge un job o un webhook dalla doppia esecuzione con chiave di idempotenza, stati chiari e regole per i nuovi tentativi. Lo copi nello strumento di IA che preferisce, che poi rende sicuri i nuovi tentativi.
- Tema
- App e prototipi
- Tipo
- Prompt
- Livello
- Avanzato
- Tempo
- circa 10 min
I risultati dipendono dallo strumento, dal modello e da ciò che inserisce.
Anteprima del risultato
Esempio: scritto dalla nostra redazione, non è una vera risposta dell'IA.
Rischio: il fornitore di pagamenti reinvia lo stesso evento se non rispondiamo entro 10 secondi. Chiave: ID evento del fornitore, indice univoco nella tabella «eventi_elaborati», conservata 30 giorni Stati: ricevuto → in lavorazione → completato / fallito Ripetizione su «completato»: restituire subito 200, non registrare nulla Nuovi tentativi: solo timeout e 5xx, al massimo 5, intervallo crescente con componente casuale, poi nell’elenco degli errori Test: inviare l’evento due volte; interruzione dopo la registrazione; due consegne contemporanee Ipotesi: il database supporta le transazioni.
Compili
Ciò che scrive resta in questa finestra del browser. Non salviamo né inviamo nulla.
- il webhook di un fornitore di pagamenti registra un pagamento
- un job invia fatture via e-mail
- un'importazione crea ordini dal negozio online
- un job recupera dati dall'API di un partner
- un endpoint crea un account cliente
- il pagamento viene registrato due volte
- il cliente riceve due volte la stessa e-mail
- l'ordine compare due volte in magazzino
- i contatori aumentano il doppio
- due account con lo stesso indirizzo e-mail
- Python con PostgreSQL e una coda di job
- Node.js con Redis
- Java con Spring e Kafka
- PHP con MySQL e cron
- Go con una coda di messaggi nel cloud
Il suo prompt
Ha modificato il prompt. Le modifiche nei campi sopra non lo sovrascrivono più.
Questa è un'istruzione per un'IA, non ancora il risultato.
Dove funziona questo prompt
Questi strumenti di IA sono adatti a questo prompt:
Come usarlo
- Compili i campi o tocchi un suggerimento. Non inserisca nomi, indirizzi o altri dati personali.
- Copi il prompt completo nello strumento di IA che preferisce.
- Prima del rilascio inserisca di proposito eventi doppi e interruzioni in un ambiente di test e verifichi che ogni effetto avvenga esattamente una volta.
Perché funziona?
Nel dubbio, reti e code consegnano due volte piuttosto che nessuna. Una chiave e stati chiari trasformano il «speriamo una volta sola» in un «ha effetto esattamente una volta» verificabile.
Consigli
- Salvi la chiave nella stessa transazione della modifica vera e propria, altrimenti resta un varco tra le due.