[실전 API 설계] - 11. API 설계 우선 방식에 변경 워크플로 구축

API 설계 우선 방식: 애플리케이션 구축에 앞서 API 정의서를 먼저 정의하는 방식

11.1. 문제

API 설계 및 구현의 상황에 공통 관심사

• API의 진실에 대한 출처
• 구현 중에 API 설계 변경을 피할 수 없는 경우, 변경을 알릴 방법
• 변경사항 통합에 대한 합의 도출 방법
• API의 변경사항을 확인할 수 있어야 함

11.2. 변경 논의와 대응

• API 정의서에 대해 신뢰할 수 있는 단일 진실 출처
• 변경을 제안하는 방법과 변경에 동의하는 방법
• 변경 내용을 비교할 수 있는 방법

위와 같은 요구사항을 깃과 같은 버전 관리 시스템을 통해 해결할 수 있음