Usa l’integrazione più semplice possibile
Un connettore standard è preferibile se copre entità, mapping, frequenza e gestione eccezioni. Il middleware è giustificato quando sistemi diversi possiedono campi distinti, le regole divergono, serve orchestrazione o il recovery è custom.
Definisci contratti a ogni confine
Documenta payload, identificatori, versione, autenticazione, valori ammessi ed errori. OpenAPI descrive contratti HTTP, ma uno schema non definisce ownership o recovery. Registra contratti tecnici e operativi.
Progetta per guasti distribuiti
Un update può riuscire in un sistema e fallire in un altro. Usa operazioni idempotenti, stato persistente, retry controllati e, quando un write deve produrre un evento, pattern come il transactional outbox. Considera i duplicati normali.
Proteggi credenziali e dati
Usa least privilege, secret gestiti, verifica delle firme e accesso auditabile. Valida i payload prima del processing. Non esporre credenziali in browser o log.
Gestisci l’operatività
Monitora throughput, latenza, scarti, code di retry e differenze di riconciliazione. Prepara runbook per scadenza token, rate limit, cambi schema, downtime e replay. Versiona i mapping.