Integrazione dei processi / 11
Ricevere webhook. Eseguire i processi operativi in modo affidabile.
Un evento arriva e deve attivare un’azione nel sistema successivo. Consegne multiple, ritardi o un’API di destinazione indisponibile trasformano il caso in un processo operativo. Lo sviluppiamo con eventi univoci ed effetti verificabili.
La situazione iniziale
HTTP 200 da solo non dimostra l’esecuzione di un processo operativo.
Uno shop invia un evento ordine. L’ERP è temporaneamente irraggiungibile. Se tutto viene eseguito nella richiesta webhook, un timeout può provocare nuove consegne; se la conferma è immediata, l’ordine può andare perso.
Separiamo la ricezione verificata dall’elaborazione successiva. Il mittente determina formato della firma e regole di consegna. L’integrazione definisce deduplicazione, conservazione e significato di una conferma riuscita.
Cosa gestisce DataSource
Separare ricezione, persistenza e azione di destinazione.
Proteggere l’ingresso
Verificare la firma sui byte originali della richiesta secondo la documentazione del mittente. Limitare dimensione, Content-Type e tipi di evento supportati.
Ricevere in modo persistente
Salvare l’evento in uno storage protetto concordato o in una queue. Restituire il codice HTTP di successo appropriato solo dopo la ricezione riuscita.
Elaborare
Utilizzare ID univoci, rendere idempotenti gli effetti e verificare le risposte della destinazione. Gestire separatamente gli errori permanenti e consentire un replay controllato.
Scenario tecnico / Esempio illustrativo
Confermare la ricezione, seguire separatamente l’elaborazione.
Payload illustrativo. eventId e orderId sono identità diverse. Una consegna ripetuta non deve necessariamente creare un nuovo ordine; il successo dell’elaborazione è uno stato distinto.
Dati di esempio e regole proposte. Le interfacce e le regole aziendali concrete vengono verificate per il vostro progetto.
{
"eventId": "evt-1042",
"type": "order.approved",
"orderId": "ORD-8421",
"version": 3
}
verified → persisted → accepted
worker → effect checked → processedGestione degli errori, sicurezza ed esercizio
Consegne duplicate ed errori parziali.
Duplicati e crash
Un ID evento da solo non basta se il worker si arresta tra l’azione di destinazione e la conferma. Anche l’effetto operativo richiede protezione dalle ripetizioni o una riconciliazione con la destinazione.
Ordine
Non ogni mittente garantisce l’ordine. Versioni o stato attuale della destinazione impediscono che un evento tardivo ripristini uno stato precedente.
Replay
Registrare in modo tracciabile stato di errore, correzione e nuova esecuzione. I payload possono contenere dati personali; conservazione e accesso vengono limitati consapevolmente.
Domande funzionali
I dettagli che contano prima dell’implementazione.
Webhook · HMAC · Queue · Deduplicazione · Replay · Stato operativo
Exactly-once è garantito?
Tra più sistemi non è una garanzia generale. Progettiamo per consegne ripetute e un’elaborazione il cui effetto operativo possa essere riconciliato in modo sicuro.
Dobbiamo sempre memorizzare l’intero record?
Solo i dati necessari per l’elaborazione e i riferimenti agli errori concordati. Retention e accesso fanno parte del modello operativo.
Che cosa fare se il mittente non fornisce un ID evento?
Una chiave affidabile può derivare da risorsa, versione e tipo di evento. Un semplice hash del payload non identifica automaticamente un evento operativo univoco.
Per il confronto tecnico
Partire dal vostro processo concreto.
Portate documentazione del mittente su firme, retry ed eventi, payload anonimizzati e azioni di destinazione desiderate. Le consegne multiple già riscontrate aiutano a definire la gestione degli errori.
Nel primo incontro chiariamo accessi disponibili, responsabilità dei dati e un primo flusso circoscritto. Poi concordiamo perimetro, responsabilità e condizioni.
Per iniziare bastano esempi anonimizzati. Non inviate password, token o dati personali di produzione nella prima richiesta.
Attività correlate
La prossima connessione nel suo contesto.
Integrazione REST API
La documentazione è disponibile e una richiesta di test funziona. Nell’uso quotidiano mancano comunque dati o si generano duplicati. DataSource collega la vostra API REST al processo aziendale concreto e pianifica anche il caso in cui la risposta non arrivi.
Sincronizzare ordini & stati
Lo shop indica il pagamento, l’ERP non conosce ancora l’ordine e la spedizione ha già un tracking number. Colleghiamo questi passaggi con stati definiti, riferimenti univoci degli ordini e un ripristino pianificato.
Automatizzare utenti & diritti di accesso
Un nuovo collaboratore richiede accessi a più applicazioni. Un cambio di team modifica i ruoli, un’uscita richiede la revoca. Colleghiamo i dati del personale di riferimento a un processo controllato per queste modifiche.
Riferimenti tecnici
Documentazione ufficiale, verificata il 6 ottobre 2026. L’idoneità dipende dall’installazione e dalla versione specifiche.