Gebruik de eenvoudigste passende integratie
Een standaardconnector heeft de voorkeur als die entiteiten, mappings, frequentie en uitzonderingen ondersteunt. Middleware is gerechtvaardigd wanneer systemen verschillende velden beheren, regels uiteenlopen, orchestratie nodig is of herstel maatwerk vraagt.
Definieer contracten op elke grens
Documenteer payloads, ID’s, versie, authenticatie, toegestane waarden en foutgedrag. OpenAPI kan HTTP-contracten beschrijven, maar een schema bepaalt geen data-eigenaarschap of herstel. Leg technische én operationele contracten vast.
Ontwerp voor gedistribueerde fouten
Een update kan in het ene systeem slagen en in het andere falen. Gebruik idempotente operaties, duurzame status, gecontroleerde retries en—wanneer een databasewrite een event moet veroorzaken—patronen zoals transactional outbox. Verwacht dubbele berichten.
Bescherm credentials en data
Gebruik minimale scopes, beheerde secrets, handtekeningcontrole en controleerbare toegang. Valideer payloads vóór verwerking. Stel platformcredentials nooit bloot in browsers of logs.
Beheer, niet alleen deploy
Monitor throughput, latency, afwijsredenen, retryqueues en reconciliatieverschillen. Houd runbooks bij voor tokenverval, rate limiting, schemawijzigingen, downtime en replay. Versioneer mappings.