버전 관리 일정

버전 관리 전략과 진화하는 스키마에 대해 자세히 확인해 보세요.

계속해서 진화하는 스키마

혁신은 추진력을 높여 앞서 나갈 때 이루어집니다. 저희는 그 누구도 혁신을 향한 걸음을 막지 못하도록 Rapid 3을 설계했습니다.

Rapid 3 및 계속해서 진화하는 스키마와 함께 준비되는 즉시 기능을 이용하실 수 있습니다. 더 이상 새로운 버전의 출시를 위해 6개월을 기다리실 필요가 없으며, 출시 때마다 업그레이드를 위해 몇 시간씩 기다리지 않으셔도 됩니다.

최신 기능이 출시되어도 통합이 중단되지 않기 때문에 Rapid 3을 오래 사용하며 시간과 비용을 절약하실 수 있습니다. 이 밖에도 미래를 계획할 수 있도록 어떤 기능이 추가될지 안내해 드립니다.

버전 관리 전략

대규모 기능을 릴리스하거나 주요 변경이 있는 경우 Rapid 4와 같이 새 버전으로 선보일 계획입니다.

Rapid API Technology 팀은 하나의 API 활성 버전을 유지 관리하고 있으며, 다른 하나는 개발 중입니다. 개발 중인 최신 버전이 출시되면 해당 버전이 활성화되며, 이전 버전은 지원 중단으로 표시됩니다. 이러한 버전은 사용이 완전히 중단되기까지 1년간 사용할 수 있으므로 충분한 여유를 두고 최신 버전으로 전환할 수 있습니다. 해당 기간에는 지원이 중단된 버전으로 주요 보안 수정 사항만 적용됩니다.

용어

버전 관리 일정을 이해하는 데 도움이 되는 몇 가지 용어의 정의는 다음과 같습니다.

활성: Rapid API의 현재 활성 버전입니다. 경미한 기능 변경 사항은 활성 버전에 언제든지 추가될 수 있습니다. 해당 기능의 통합 여부는 직접 결정할 수 있습니다.

개발: 현재 개발 중인 Rapid의 차기 버전입니다.

사용 중단: 버전이 사용 중단으로 표시된 경우 1년 후에는 해당 버전을 더 이상 사용할 수 없습니다. 이때 최신 활성 버전으로의 업그레이드가 필요합니다.

사용 종료: 버전의 지원이 종료되면 API를 통해 해당 버전에 더 이상 액세스할 수 없습니다.

경미한 변경 사항: 경미한 변경 사항은 언제든지 활성 버전에 추가될 수 있으며, 통합을 방해하지 않는 기능입니다.

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

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

중대한 변경 사항: 중대한 변경 사항은 기존 통합을 방해할 수 있는 대규모 기능 업데이트입니다. 중대한 변경 사항은 Rapid의 새로운 활성 버전에만 출시하므로 기존 통합에 대해 걱정하지 않으셔도 됩니다.

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

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