API evolution
버전 관리와 API 진화 전략
API 버전 관리는 기존 클라이언트를 깨지 않으면서 새 기능과 변경 사항을 배포하기 위한 계약 관리다.
호환성 우선
비파괴 변경
선택 필드 추가, 새 엔드포인트 추가처럼 기존 응답을 깨지 않는 변경.
same version
파괴 변경
필드 삭제, 의미 변경, 인증 방식 변경처럼 기존 클라이언트가 실패할 변경.
new version
운영 전략
지원 종료 공지, 마이그레이션 기간, 로그 기반 사용량 확인을 함께 둔다.
deprecatemigrate