1
기존 클라이언트를 깨뜨리는 변경 구분
응답 필드 삭제, 의미 변경, 인증 방식 교체처럼 기존 호출을 실패하게 만드는 변경은 새 버전으로 분리해 배포해야 합니다.
버전 관리(Versioning)
2
API 버전 관리 전략
URI 버전은 눈에 잘 보이고, 헤더·미디어 타입 버전은 URL을 유지할 수 있지만 클라이언트와 캐시 설정까지 함께 맞춰야 합니다.
API 진화 전략
3
API 진화 전략 및 고려사항
변경 로그, deprecation 기간, 마이그레이션 예제를 함께 제공해야 새 계약으로 넘어가는 비용을 예측할 수 있습니다.
깨뜨리지(break)