Versioning styles
NestJS API 버전 관리 방식 비교
버전 정보는 URL, 헤더, 미디어 타입 중 하나에 실을 수 있다. 선택 기준은 클라이언트 가시성과 운영 통제다.
방식 비교
| 방식 | 예시 | 장점 | 주의 |
|---|---|---|---|
| URI Versioning | /v1/users | 브라우저와 문서에서 가장 잘 보인다. | URI가 버전별로 늘어난다. |
| Header Versioning | X-Version: 1 | URI를 깔끔하게 유지한다. | 클라이언트 설정 누락을 확인해야 한다. |
| Media Type | Accept: app/vnd.v1 | 표현 형식과 버전을 함께 관리한다. | 초기 학습과 테스트가 번거롭다. |