비파괴 변경
기존 클라이언트가 수정 없이 계속 동작하는 변경이다.
선택 필드 추가
새 엔드포인트
버전 관리는 API 계약을 깨지 않고 진화시키는 장치다
새 기능을 배포하더라도 기존 클라이언트가 같은 요청으로 같은 의미의 응답을 받을 수 있어야 한다.
파괴 변경
응답 구조나 의미가 바뀌어 기존 클라이언트가 실패할 수 있다.
필드 삭제
인증 변경
운영 전략
지원 종료 공지, 마이그레이션 기간, 사용 로그 확인을 함께 둔다.
공지
이전 기간
핵심: 변경이 기능 문제가 아니라 클라이언트와의 계약 문제인지 먼저 판단한다.