🌿 중급 백엔드
API 버전 관리 방법
쉽게 이해하기
앱을 업데이트했는데 예전 버전을 쓰는 사람들도 있잖아요. API 버전 관리는 새 기능을 추가하면서도 옛날 버전 쓰는 사람들이 계속 작동하게 해주는 거예요. 마치 구형 앱도 서버와 통신할 수 있게 하는 것처럼요.
핵심 정리
API를 업데이트할 때 기존 사용자를 배려하는 버전 관리 전략이에요.
자세히 알아보기
API는 한번 만들면 끝이 아니라 계속 발전해요. 새로운 기능을 추가하거나 구조를 개선해야 할 때가 있는데, 문제는 이미 많은 클라이언트가 기존 API를 사용하고 있다는 거예요. 갑자기 API를 바꾸면 모든 앱이 오류를 일으킬 수 있어요.
그래서 API 버전 관리가 필요해요. 가장 흔한 방법은 URL에 버전을 넣는 거예요. 예를 들어 `/api/v1/users`와 `/api/v2/users`처럼요. 이렇게 하면 v1을 쓰던 클라이언트는 계속 v1을 쓰고, 새로운 클라이언트만 v2를 사용할 수 있어요. 각 버전은 독립적으로 작동하니까 호환성 문제가 없어요.
다른 방법으로는 헤더에 버전을 명시하는 방식도 있어요. `Accept: application/vnd.myapi.v2+json` 같은 헤더를 보내면 서버가 v2 응답을 보내는 식이죠. URL은 깔끔하게 유지되지만, 헤더를 확인해야 해서 약간 복잡할 수 있어요.
실무에서는 보통 2~3개 버전을 동시에 지원하고, 구버전은 일정 기간 후 지원 중단(deprecated)을 선언해요. 예를 들어 'v1은 6개월 후 종료됩니다'라고 미리 공지하고, 사용자들이 마이그레이션할 시간을 주는 거죠. 갑작스러운 변경은 사용자 신뢰를 잃게 만들기 때문에 버전 관리는 API 설계의 핵심이에요.