Hoe maak je een catalogus van interfaces tussen systemen?

Question

IT Interview Practice · Accepted Answer

Bouw een **interfacecatalogus** als een onderhouden inventaris van systeemcontracten en hun eigenaren. Zo verbind je een architectuurdiagram met de details die teams nodig hebben voor implementatie, incidentafhandeling en wijzigingsplanning.

## Begin bij bedrijfsprocessen

Doorloop een echt proces, zoals orderafhandeling, en inventariseer iedere API-aanroep, gebeurtenis, bestandsoverdracht en geplande gegevensuitwisseling. Neem minder zichtbare paden mee, zoals reconciliatie-exports en handmatige herstelimports.

Leg voor iedere interface vast:

- Een stabiele identificatie, bedrijfsdoel, producent, afnemers en verantwoordelijke contactpersonen.
- Richting, transport, endpoint of bestandslocatie en een link naar het geversioneerde schema.
- Gegevenseigenaarschap, identificaties, classificatie en toegangsmechanisme, zonder inloggegevens op te slaan.
- Timing of planning, verwacht volume, payloadlimieten en afgesproken serviceverwachtingen.
- Regels voor timeouts, herhaalpogingen, duplicaten, volgorde en foutafhandeling waar relevant.
- Monitoring, escalatie, compatibiliteitsbeleid en afhankelijkheden bij uitfasering.

## Voorbeeldregistratie

Interface IF-07 stuurt elke 15 minuten verzendbevestigingen van een magazijn naar een orderplatform. Het magazijn beheert de feed; het orderplatform beheert de inname. Het contract definieert een verzendidentificatie, schemaversie, aantal records en bevestigingsbestand. Ontbrekende bevestigingen worden geëscaleerd naar een benoemd supportteam.

Dit is nuttiger dan een pijl met “integratie”: een team kan bepalen of een vertraagde verzendupdate voortkomt uit een transportfout, afgewezen gegevens of een gemist tijdschema.

## Houd de catalogus betrouwbaar

Link naar schema’s en draaiboeken in plaats van hun inhoud te dupliceren. Werk de catalogus bij wanneer een interface verandert en vergelijk hem regelmatig met waargenomen verkeer en geplande taken. Een statische inventaris mist al snel onofficiële verbindingen.

## Valkuil tijdens een gesprek

Alleen een endpointlijst beschrijft geen contract. Een sterk antwoord bevat zakelijke betekenis, eigenaarschap en foutgedrag, met een detailniveau dat onderhoudbaar blijft.

Begin bij bedrijfsprocessen

Voorbeeldregistratie

Houd de catalogus betrouwbaar

Valkuil tijdens een gesprek

Gerelateerde vragen