URI Version
/v1/users처럼 주소만 봐도 버전이 보입니다.
Nest · version
NestJS API 버전 관리 방식 비교
버전 정보가 URL, Header, Media Type 중 어디에 실리는지에 따라 라우트 선택과 운영 방식이 달라집니다.
버전 전략 비교
versioningHeader Version
클라이언트가 전용 헤더로 버전을 보냅니다.
Media Type
Accept 헤더의 타입 정보에 버전을 담습니다.
Controller Route
Nest가 버전에 맞는 핸들러를 선택합니다.
Migration
기존 API와 새 API를 일정 기간 함께 운영합니다.
request
→
version source
→
router match
→
controller
→
response
API 버전 관리 방식 정리
API 버전 관리는 새 URL을 만드는 일이 아니라 기존 클라이언트와 새 기능을 동시에 운영하기 위한 계약 관리입니다.