인터페이스 요구사항 명세
시스템 간 데이터·기능 연계를 위해 무엇을 주고받을지를 명문화하는 단계.
인터페이스 명세서가 포함해야 할 항목을 묻는 단답형이 출제된다. 특히 내부 인터페이스와 외부 인터페이스의 구분, 요구사항 분류가 핵심.
인터페이스 요구사항은 '어떤 시스템과, 어떤 데이터를, 어떤 형식·주기로 주고받을지'를 정의하는 요구사항이다. 기능 요구사항(무엇을 할지)과 비기능 요구사항(성능·보안·가용성 등)으로 나뉘며, 시스템 경계를 기준으로 내부 인터페이스와 외부 인터페이스를 구분한다.
| 구분 | 대상 | 예시 |
|---|---|---|
| 내부 인터페이스 | 하나의 시스템 안 모듈·컴포넌트 간 | 주문 모듈 → 결제 모듈 함수 호출 |
| 외부 인터페이스 | 서로 다른 시스템·조직 간 | 쇼핑몰 → PG사 결제 API, 공공 데이터 Open API |
인터페이스 명세서 필수 항목 — ① 인터페이스 ID ② 송신·수신 시스템 ③ 데이터 항목(필드·타입·길이) ④ 연계 방식(직접/간접) ⑤ 통신 유형(동기/비동기) ⑥ 처리 주기(실시간/배치) ⑦ 오류 처리 방안
기능 vs 비기능 요구사항 — 기능은 '결제 승인 요청을 송신한다' 같은 동작이고, 비기능은 '응답 3초 이내·TLS 1.2 이상' 같은 품질 제약이다. 단답형에서 이 둘을 섞어 내는 함정 주의.
요구사항 확인 단계에서는 요구사항 검토(Review) 와 프로토타이핑을 통해 누락·모호·충돌을 잡아낸다. 인터페이스 요구사항의 모호성은 나중에 연계 오류로 직결되므로 이 단계의 품질이 특히 중요하다.
쇼핑몰 시스템에서 외부 PG사와 결제 승인을 주고받는 연계는 내부 인터페이스와 외부 인터페이스 중 어느 쪽인가?
인터페이스 명세서에 포함되어야 하는 항목 4가지 이상을 쓰시오.
인터페이스의 응답 시간 3초 이내 제약은 기능 요구사항에 해당한다.
연계 방식 중 ( ㉠ ) 연계는 DB Link·API·JDBC처럼 시스템끼리 직접 연결하는 방식이고, ( ㉡ ) 연계는 EAI·ESB·소켓처럼 중계 미들웨어를 거치는 방식이다.