Bagaimana membuat katalog antarmuka lintas sistem?

Question

IT Interview Practice · Accepted Answer

Bangun **katalog antarmuka** sebagai inventaris kontrak antarsistem dan pemiliknya yang terus dipelihara. Katalog ini menghubungkan diagram arsitektur dengan detail yang dibutuhkan tim untuk implementasi, respons insiden, dan perencanaan perubahan.

## Mulai dari alur bisnis

Telusuri proses nyata, seperti pemenuhan pesanan, lalu daftarkan setiap panggilan API, event, transfer file, dan pertukaran data terjadwal. Sertakan jalur yang kurang terlihat, seperti ekspor rekonsiliasi dan impor pemulihan manual.

Untuk setiap antarmuka, catat:

- Pengenal stabil, tujuan bisnis, produsen, konsumen, dan kontak yang bertanggung jawab.
- Arah, transport, endpoint atau lokasi file, serta tautan ke skema berversi.
- Kepemilikan data, pengenal, klasifikasi, dan mekanisme akses, tanpa menyimpan kredensial.
- Waktu atau jadwal, volume yang diharapkan, batas payload, dan ekspektasi layanan yang disepakati.
- Aturan timeout, percobaan ulang, duplikasi, urutan, dan penanganan kesalahan jika berlaku.
- Pemantauan, eskalasi, kebijakan kompatibilitas, dan dependensi penghentian.

## Contoh entri

Antarmuka IF-07 mengirim konfirmasi pengiriman dari gudang ke platform pesanan setiap 15 menit. Gudang memiliki feed; platform pesanan memiliki proses ingestion. Kontrak menetapkan pengenal pengiriman, versi skema, jumlah rekaman, dan file konfirmasi penerimaan. Konfirmasi yang tidak diterima dieskalasikan ke tim dukungan yang ditunjuk.

Ini lebih berguna daripada panah berlabel “integrasi”: tim dapat mengetahui apakah keterlambatan pembaruan pengiriman disebabkan kegagalan transport, data yang ditolak, atau jadwal yang terlewat.

## Jaga keandalan katalog

Tautkan ke skema dan runbook, alih-alih menggandakan isinya. Perbarui katalog ketika antarmuka berubah, dan bandingkan secara berkala dengan lalu lintas yang diamati serta job terjadwal. Inventaris statis cepat melewatkan koneksi tidak resmi.

## Kekeliruan dalam wawancara

Daftar endpoint saja tidak menjelaskan kontrak. Jawaban yang kuat mencakup makna bisnis, kepemilikan, dan perilaku kegagalan, sambil memilih tingkat detail yang masih dapat dipelihara.

Mulai dari alur bisnis

Contoh entri

Jaga keandalan katalog

Kekeliruan dalam wawancara

Pertanyaan terkait