Minaensa Design
Systemen verbinden met duidelijke afspraken over gegevens
Een koppeling moet meer doen dan eenmalig gegevens versturen. Ook fouten, wijzigingen en verschillen tussen systemen horen bij de opdracht.
Onderzoek de beschikbare toegang
Controleer documentatie, toestemming en beperkingen van de betrokken systemen. Een gewenste integratie is pas toezegbaar nadat de mogelijkheden zijn beoordeeld. Houd rekening met afhankelijkheden van externe leveranciers.
Wat is de bron van waarheid?
Leg per gegeven vast welk systeem leidend is. Bepaal hoe dubbele of ontbrekende records worden behandeld. Een wijziging mag niet eindeloos tussen twee systemen heen en weer blijven gaan.
Fouten zichtbaar en herstelbaar
Maak afspraken over logging, herhaling en beheer. Gevoelige gegevens horen niet ongefilterd in foutmeldingen. Test een onderbroken verbinding zodat duidelijk is hoe de koppeling later veilig verdergaat.
Praktijkvoorbeeld en integratiecontrole
Bij Totaalbedrukt.nl is een RDW-koppeling beschreven waarmee voertuiggegevens worden opgehaald, naast andere API-koppelingen. Leg voor een nieuwe koppeling bron, toegestane velden, ontvanger en foutgedrag vast. Test een niet-beschikbare bron en een herhaald bericht; controleer of de ingerichte foutafhandeling en herhaalbeveiliging dubbele verwerking en onjuiste bevestigingen voorkomen. Iedere externe API vraagt eigen toegangs- en scopebeoordeling.