NestJS에서 API 버전 관리하기(Versioning)

REST API와 같은 서버 애플리케이션을 운영하다 보면, 부득이하게 클라이언트에 큰 영향을 줄 수 있는 위험한 변경을 해야할 때가 있는데요. API Versioning, 즉 버전 관리를 통해서, 우리는 서버 측 API 변경에 따른 클라이언트의 영향을 최소화하고, API의 호환성과 안정성을 높일 수 있습니다.


버전 관리가 이루어지는 API는 보통 클라이언트에게 v1, v2, v3… 이런 식으로 여러 버전의 API를 제공하는데요. 그리고 클라이언트 애플리케이션에 문제를 일으킬 소지가 있는 변경이 발생하면 버전을 올리게 됩니다. 따라서, 클라이언트는 기존 버전을 사용하다가, 준비가 되었을 때 신규 버전으로 넘어갈 수 있죠.


다시 말해서, API Versioning을 통해서 서버 측에서는 보다 유연하게 API 변경 사항을 배포할 수 있고, 클라이언트 측에서는 위험한 변경 사항을 인지한 상태에서 충분히 테스트 후에 버전 업그레이드를 할 수 있게 됩니다.


이번 글에서는 NestJS에서 API의 버전을 체계적으로 관리하는 방법에 대해서 배워보도록 하겠습니다.


📝 포스팅: https://www.daleseo.com/nestjs-versioning/

🧑‍💻 실습 코드: https://stackblitz.com/edit/nestjs-versioning


NestJS를 공부하고 계신다면 아래 게시물도 같이 참고해보시면 도움이 될 것 같습니다.

📕 NestJS 처음 시작하기: https://careerly.co.kr/comments/88486
📗 NestJS로 REST API 찍어내기: https://careerly.co.kr/comments/88984
📘 NestJS에서 로깅(logging)하기: https://careerly.co.kr/comments/89270
📙 NestJS 앱의 환경 설정: https://careerly.co.kr/comments/90498
📓 NestJS의 liveness/readiness 엔드포인트: https://careerly.co.kr/comments/91046

📔 가드(Guard)로 NestJS 앱 안전하게 지키기: https://careerly.co.kr/comments/91745

NestJS에서 API 버전 관리하기(Versioning)

www.daleseo.com

NestJS에서 API 버전 관리하기(Versioning)

다음 내용이 궁금하다면?

또는

이미 회원이신가요?

2024년 1월 9일 오후 10:39

 • 

저장 27조회 3,875

댓글 0