경로에 v1 표시
/v1/users처럼 눈에 잘 보이고 테스트가 쉽지만 URL 구조가 버전마다 갈라집니다.
버전 계획
API 버전 호환성 기준
URI, 헤더, 미디어 타입 버전 관리는 노출 방식이 다를 뿐 핵심은 변경 범위와 지원 기간을 관리하는 일입니다.
요청 헤더로 선택
경로를 유지하면서 클라이언트가 버전을 고르지만 디버깅과 문서 표시가 더 중요해집니다.
Accept 기반 협상
표준적인 콘텐츠 협상을 활용하지만 팀과 클라이언트가 이해해야 할 규칙이 늘어납니다.
점진적 진화
필드 추가, deprecate 표시, 기본값 유지로 기존 앱을 깨지 않고 기능을 확장합니다.