인터페이스 명세·데이터 표준과 연계 방식
인터페이스 명세와 데이터 변환 규칙을 확인하고 연계 구조·웹 서비스·비동기 처리의 차이를 익힌다.
인터페이스 설계 확인
인터페이스 구현은 서로 다른 모듈·시스템이 정해진 기능과 데이터 규칙에 따라 정보를 주고받도록 만드는 작업이다. 설계 산출물에서 인터페이스 목록과 상세 명세를 확인하고 실제 구현과 대조한다.
| 산출물 | 확인할 내용 |
|---|---|
| 시스템 구성도·인터페이스 목록 | 송신·수신 대상, 연결 관계, 연계 목적 |
| 인터페이스 명세서 | 기능, 호출 시점, 처리 절차, 정상·오류 응답 |
| 데이터 정의서·코드 정의서 | 필드명, 자료형, 길이, 필수 여부, 값의 의미 |
| 매핑 정의서 | 송신 필드와 수신 필드의 대응 및 변환 규칙 |
인터페이스 변경은 관련 명세와 송수신 구현에 함께 반영한다. 요청 필드뿐 아니라 응답 필드와 오류 코드도 호환성 확인 대상이다.
데이터 표준과 변환
표준 단어·용어·도메인·코드를 정하고 자료형·길이·정밀도·단위·인코딩·시간대를 일치시킨다. 같은 숫자 100이어도 원과 천 원은 다르다. 문자형 식별자 ‘0032’의 선행 0을 임의로 없애지 않는다.
필드 누락, null, 빈 문자열은 서로 다른 상태다. 기본값 대입과 숫자 반올림·절삭은 명세된 규칙을 따른다. 코드 변환이 다대일이면 서로 다른 원래 값이 합쳐지므로 역변환에 필요한 정보가 사라질 수 있다.
고정 길이 전문은 필드 시작 위치·길이·자료형으로 해석한다. ASCII 전문 003207Y에서 ID 4자리·수량 2자리·상태 1자리라면 ID는 ‘0032’, 수량은 7, 상태는 Y다. UTF-8의 한글처럼 문자 수와 바이트 수가 다른 경우에는 길이의 기준도 확인한다.
연계 방식과 흐름

전송이 끝나도 수신 검증과 업무 반영을 확인해야 한다. 검증에 실패한 자료는 업무에 반영하지 않는다.
| 구분 기준 | 방식 |
|---|---|
| 연결 경로 | 직접 연계: DB 연결·API 등 / 간접 연계: EAI·ESB·메시지 브로커 등 중계 활용 |
| 결과 대기 | 동기: 결과를 기다림 / 비동기: 요청과 결과 처리를 분리 |
| 처리 시점 | 실시간: 발생에 맞춰 처리 / 배치: 모아서 일괄 처리 |
이 세 기준은 독립적으로 판단한다. 간접 연계라고 항상 비동기·배치인 것은 아니다. 송신 → 전송 → 수신 검증 → 업무 반영의 순서를 확인하고 전송 성공과 최종 업무 성공을 구분한다.
EAI의 Point-to-Point는 일대일 연결, Hub & Spoke는 중앙 허브, Message Bus는 공통 버스, Hybrid는 여러 방식의 조합이다. 모든 시스템 쌍을 직접 연결하면 연결 수가 빠르게 증가하고, 중앙 허브에는 병목·장애 집중 가능성이 있다.
데이터 표현과 웹 서비스
| 기술 | 역할 |
|---|---|
| XML | 요소·속성·중첩 구조로 데이터 표현 |
| JSON | 객체·배열·이름과 값의 쌍으로 데이터 표현 |
| SOAP | XML 기반 메시지 교환 규칙 |
| WSDL | 웹 서비스의 기능·메시지·접속 방법 기술 |
| UDDI | 웹 서비스 정보를 등록·검색 |
| AJAX | 웹 페이지 전체를 다시 불러오지 않고 서버와 데이터를 교환 |
SOAP의 Envelope는 전체 메시지, Header는 선택적 부가 정보, Body는 필수 본문이다. Fault는 오류 정보를 나타내며 Body 안에 위치한다. 직렬화는 데이터를 전송 형식으로 바꾸고, 파싱은 받은 데이터를 구조로 읽는 과정이다.
비동기 인터페이스의 완료 판단
HTTP 202 Accepted는 요청이 접수됐지만 처리가 완료되지 않았음을 뜻한다. 최종 상태는 작업 식별자와 상태 조회·완료 통지로 확인한다. 비동기 응답은 요청 순서와 다르게 도착할 수 있으므로 식별자와 순서를 명세한다.
HTTP 메서드의 안전성은 요청 의미가 읽기 중심인지에 관한 성질이다. GET 요청에도 서버의 접근 로그 기록은 생길 수 있다. 안전한 메서드라는 말은 전송 암호화나 접근 권한 검사를 대신하지 않는다.