API 계약은 호출 방법과 결과의 형태를 명시합니다. 경로와 메서드뿐 아니라 필드 타입, 필수 여부, 상태 코드, 인증 조건까지 포함합니다. 이를 문서와 스키마로 표현하면 클라이언트·서버가 각자 구현해도 같은 기준으로 검증할 수 있습니다.
데모에서는 응답에 선택 필드를 추가할 때 구형 클라이언트가 계속 통과하지만, 필수 필드 이름을 바꾸면 계약 연결이 끊깁니다. 변경 전에는 소비자와 호환성 영향을 먼저 확인해야 합니다.
언제 쓰나
여러 팀·서비스가 API를 독립 구현하거나 공개 API를 오래 유지할 때 중요합니다.