경로 버전
/v1/users처럼 명확하고 라우팅이 쉽지만 URL 확산과 중복 controller가 생길 수 있습니다.
API Evolution
API 버전 변경 비용 관리
URI, header, media type 버전 전략을 선택할 때 호환성, 캐시, 게이트웨이 라우팅, 폐기 공지를 함께 판단합니다.
헤더 버전
X-API-Version은 URL을 유지하지만 클라이언트와 프록시 설정에서 누락 검사를 강화해야 합니다.
미디어 타입
Accept header 버전은 정교하지만 문서와 테스트 자동화가 없으면 운영 난도가 높습니다.
폐기 절차
breaking change는 sunset header, changelog, migration guide, 모니터링 기간을 묶어 진행합니다.