Kako izrađujete katalog sučelja između sustava?

Question

IT Interview Practice · Accepted Answer

Izradite **katalog sučelja** kao održavani inventar ugovora između sustava i njihovih vlasnika. Povezuje arhitektonski dijagram s pojedinostima potrebnima timovima za implementaciju, odgovor na incidente i planiranje promjena.

## Počnite poslovnim tokovima

Prođite kroz stvarni proces, primjerice ispunjenje narudžbe, i navedite svaki API poziv, događaj, prijenos datoteke i zakazanu razmjenu podataka. Uključite manje vidljive putove poput izvoza za usklađivanje i ručnih uvoza za oporavak.

Za svako sučelje zabilježite:

- Stabilan identifikator, poslovnu svrhu, proizvođača, potrošače i odgovorne kontakte.
- Smjer, prijenos, endpoint ili lokaciju datoteke te vezu na verzioniranu shemu.
- Vlasništvo nad podacima, identifikatore, klasifikaciju i mehanizam pristupa bez pohrane vjerodajnica.
- Vremenska pravila ili raspored, očekivani volumen, ograničenja sadržaja poruke i dogovorena očekivanja usluge.
- Pravila isteka vremena, ponovnih pokušaja, duplikata, redoslijeda i obrade pogrešaka gdje je primjenjivo.
- Nadzor, eskalaciju, politiku kompatibilnosti i ovisnosti pri povlačenju iz uporabe.

## Primjer stavke

Sučelje IF-07 šalje potvrde otpreme iz skladišta na platformu za narudžbe svakih 15 minuta. Skladište posjeduje izvor podataka; platforma posjeduje unos. Ugovor definira identifikator pošiljke, verziju sheme, broj zapisa i datoteku potvrde. Nedostajuće potvrde eskaliraju se imenovanom timu podrške.

To je korisnije od strelice označene „integracija”: tim može utvrditi je li zakašnjelo ažuriranje pošiljke posljedica pogreške prijenosa, odbijenih podataka ili propuštenog rasporeda.

## Održavajte pouzdanost kataloga

Povezujte sheme i operativne upute umjesto dupliciranja njihova sadržaja. Ažurirajte katalog kada se sučelje promijeni i povremeno ga usporedite s opaženim prometom i zakazanim poslovima. Statičan inventar brzo propušta neslužbene veze.

## Zamka na razgovoru

Sam popis endpointa ne opisuje ugovor. Snažan odgovor uključuje poslovno značenje, vlasništvo i ponašanje pri otkazu uz razinu detalja koja se može održavati.

Počnite poslovnim tokovima

Primjer stavke

Održavajte pouzdanost kataloga

Zamka na razgovoru

Povezana pitanja