Kako zgradite katalog vmesnikov med sistemi?

Question

IT Interview Practice · Accepted Answer

**Katalog vmesnikov** zgradite kot vzdrževan popis pogodb med sistemi in njihovih lastnikov. Povezuje arhitekturni diagram s podrobnostmi, ki jih ekipe potrebujejo za izvedbo, odziv na incidente in načrtovanje sprememb.

## Začnite pri poslovnih tokovih

Sprehodite se skozi dejanski proces, na primer izpolnitev naročila, in naštejte vsak klic API, dogodek, prenos datoteke in načrtovano izmenjavo podatkov. Vključite manj vidne poti, kot so usklajevalni izvozi in ročni obnovitveni uvozi.

Za vsak vmesnik zabeležite:

- Stabilen identifikator, poslovni namen, proizvajalca, porabnike in odgovorne kontakte.
- Smer, transport, endpoint ali lokacijo datoteke ter povezavo do različic sheme.
- Lastništvo podatkov, identifikatorje, klasifikacijo in dostopni mehanizem brez shranjevanja poverilnic.
- Časovne lastnosti ali urnik, pričakovani obseg, omejitve vsebine in dogovorjena storitvena pričakovanja.
- Pravila časovnih omejitev, ponovitev, dvojnikov, vrstnega reda in obravnave napak, kjer veljajo.
- Nadzor, stopnjevanje, politiko združljivosti in odvisnosti ob ukinitvi.

## Primer vnosa

Vmesnik IF-07 vsakih 15 minut pošlje potrditve odpreme iz skladišča v platformo naročil. Skladišče je lastnik toka, platforma naročil pa prevzema podatkov. Pogodba določi identifikator odpreme, različico sheme, število zapisov in potrditveno datoteko. Manjkajoče potrditve se stopnjujejo do imenovane podporne ekipe.

To je uporabnejše od puščice »integracija«: ekipa lahko ugotovi, ali zamujena posodobitev odpreme pomeni transportno napako, zavrnjene podatke ali izpuščen termin.

## Ohranite zanesljivost kataloga

Povežite sheme in operativna navodila, namesto da podvajate vsebino. Katalog posodobite ob spremembi vmesnika in ga občasno primerjajte z opaženim prometom ter načrtovanimi opravili. Statičen popis hitro spregleda neuradne povezave.

## Past na razgovoru

Seznam endpointov sam ne opisuje pogodbe. Dober odgovor vključuje poslovni pomen, lastništvo in vedenje ob odpovedi ter izbere obvladljivo raven podrobnosti.

Začnite pri poslovnih tokovih

Primer vnosa

Ohranite zanesljivost kataloga

Past na razgovoru

Povezana vprašanja