버전 관리 일정

예약 분석 API의 진화하는 스키마 및 버전 관리 전략에 대해 자세히 알아보세요.

계속해서 진화하는 스키마

빠르게 변화하는 기술의 시대에는 앞서나가는 것이 중요합니다. 이에 따라 분석 API는 고객의 요구에 부응할 수 있도록 설계되었습니다. 진화하는 스키마를 통해 새로운 기능이 개발되는 즉시 이용할 수 있습니다. 새 릴리스를 오래 기다리거나 번거로운 업그레이드 과정을 거치지 않아도 됩니다.

최신 기능은 원활하게 통합되도록 설계되어 중단 없이 현재 버전을 계속 사용할 수 있습니다. 이 접근 방식으로 시간과 비용을 모두 절약할 수 있습니다. 향후 출시될 기능에 대한 정보를 지속적으로 제공하여 효과적으로 계획을 세울 수 있도록 도와드리겠습니다.

버전 관리 전략

기존 통합에 영향을 미칠 수 있는 중요한 업데이트 또는 변경 사항이 발생할 경우 분석 API v2와 같은 새 버전을 출시합니다.

API 팀은 하나의 활성 버전을 관리하면서 다음 버전을 개발합니다. 새 버전이 출시되면 해당 버전이 활성 버전이 되고 이전 버전은 사용이 중단됩니다. 더 이상 사용되지 않는 버전은 1년간은 계속 사용할 수 있으므로 전환하기에 충분한 시간이 있습니다. 이 기간 동안에는 더 이상 사용되지 않는 버전에 대해 중요한 보안 업데이트만 수행됩니다.

용어

아래와 같은 용어 정의를 통해 버전 관리 일정을 쉽게 이해할 수 있습니다.

활성: 분석 API의 현재 버전으로, 경미한 변경 사항과 기능이 추가된 버전입니다. 원하는 대로 이러한 기능을 유연하게 통합할 수 있습니다.

개발: 개발 중인 API 버전으로 출시가 예정되어 있습니다.

사용 중단: 사용 중단으로 표시된 버전은 해당 버전이 1년 후에 단계적으로 중단됩니다. 이 기간에 최신 활성 버전으로 업그레이드하는 것이 좋습니다.

지원 종료: 지원 종료된 버전은 더 이상 API를 통해 액세스할 수 없습니다.

경미한 변경: 기존 설정에 영향을 주지 않고 통합할 수 있는 업데이트입니다. 여기에는 새로운 엔드포인트, 선택적 쿼리 매개변수, 응답 필드 등의 추가 사항이 포함됩니다.

경미한 변경 사항은 다음을 포함합니다.

새로운 엔드포인트 추가
새로운 쿼리 매개변수(선택 사항) 추가
요청 본문에 새로운 요청 필드(선택 사항) 추가
요청에 새로운 헤더(선택 사항) 추가
필수 요청 매개변수를 선택 사항으로 변경
응답에 새로운 필드 추가
응답에 새로운 헤더 추가
요청 열거형에 새 값 추가
기본값으로 응답 열거형에 새 값 추가

중대한 변경: 통합 변경이 필요할 수 있는 중요한 업데이트입니다. 여기에는 엔드포인트 제거, 새로운 필수 매개변수 출시, 인증 구성 변경 등이 포함됩니다. 중대한 변경 사항은 새로운 활성 버전의 API에만 추가됩니다.

중대한 변경 사항은 다음을 포함합니다.

기존 엔드포인트가 제거됨
새로운 쿼리 매개변수(필수 사항) 추가
요청 본문에 새로운 요청 필드(필수 사항) 추가
요청에 새로운 헤더(필수 사항) 추가
선택적 요청 매개변수가 필수 사항이 됨
쿼리 매개변수 제거 또는 이름 바꾸기
응답 필드 제거 또는 이름 바꾸기
쿼리 매개변수 유형 변경
요청 본문의 요청 필드 유형 변경
기존 매개변수에 새 검증 요구사항 추가
인증 또는 승인 구성 삭제 또는 제거
열거형 값 제거 또는 이름 바꾸기
기본값이 아닌 경우 응답 열거형에 새 값 추가