API 버저닝은 클라이언트가 기대하는 계약을 식별하고 여러 계약을 일정 기간 함께 제공하는 방법입니다. 경로, 헤더, 미디어 타입 등으로 버전을 고를 수 있습니다. 새 버전은 파괴적인 변경을 분리하지만 운영 중인 버전 수가 늘면 테스트·문서·지원 비용도 커집니다.
데모는 v1 요청과 v2 요청을 각각의 응답 계약으로 라우팅하고, 비교 막대를 움직여 두 계약의 필드 차이를 보여줍니다. 버전 번호만 올리기보다 실제 호환성 검사와 구버전 종료 시점을 함께 계획해야 합니다.
언제 쓰나
운영 중인 API에 기존 소비자를 깨는 변경이 필요할 때 사용합니다.