여러 버전 작업하기
API Designer를 사용하면 동일한 API 정의의 여러 버전으로 작업하여 API 수명 주기를 관리할 수 있습니다. 다음을 수행할 수 있습니다.
- 새 버전에 중요하거나 호환성을 깨는 변경 사항을 도입하는 동안 프로덕션 환경에서 기존 API 버전을 유지합니다.
- 게시된 버전에 대한 가시성과 제어력을 확보합니다.
- API 변경 사항을 설계할 때 유연성을 확보합니다.
API의 새 버전을 생성하면 모든 콘텐츠가 새 버전으로 복사되며, 각 버전은 다른 버전에 영향을 주지 않고 독립적으로 수정할 수 있습니다.
API Designer 홈페이지에는 사용자가 소유한 모든 API와 사용자와 공유된 모든 API 버전이 표시됩니다.
새 API 버전 생성하기
기존 API 정의의 새 버전을 생성합니다.
사용자는 API의 소유자이거나 API의 하나 이상의 버전에 대한 편집자입니다.
- 복사하려는 버전 옆의
버튼을 클릭하고 <version>에서 새 버전 생성을 클릭합니다.
소스 버전과 동일한 콘텐츠로 API의 새 버전이 생성됩니다. 모의(mock) 및 문서화는 기본적으로 비활성화되어 있습니다.
API 버전 삭제하기
사용자는 API의 소유자입니다.
- 홈페이지에서 삭제하려는 버전 옆의 버튼을 클릭하고 삭제를 클릭합니다.
선택한 버전이 삭제됩니다. 전체 API를 삭제하려면 각 버전을 삭제해야 합니다.
버전 콘텐츠 가져오기
기존 계약의 콘텐츠를 API 버전으로 가져와서 현재 콘텐츠를 바꾸거나 병합합니다.
사용자는 API의 소유자이거나 API 버전의 편집자입니다.
새 버전을 생성하지 않고 외부 계약 파일에서 버전을 업데이트하려면 이 기능을 사용합니다. 버전 식별자는 가져오기 과정 내내 유지됩니다.
이것은 API Designer에서 새 API를 생성하는 정의 가져오기와는 다릅니다.
- 업데이트하려는 버전에 대해 버전 콘텐츠 가져오기를 엽니다.
다음 위치에서 이 작업에 액세스할 수 있습니다.
- 홈페이지에서 버전 옆의 메뉴 버튼을 클릭하고 버전 콘텐츠 가져오기를 클릭합니다.
- 홈페이지에서 버전을 선택하여 세부 정보 창을 연 다음 버전 콘텐츠 가져오기를 클릭합니다.
- 버전 편집기에서 를 클릭합니다.
- 홈페이지에서 버전 옆의 메뉴 버튼을 클릭하고 버전 콘텐츠 가져오기를 클릭합니다.
- 동작에서 가져온 콘텐츠를 적용하는 방법을 선택합니다.
- 바꾸기: 현재의 모든 콘텐츠를 가져온 계약으로 덮어씁니다. API 이름, 버전 식별자 및 사양 버전은 유지됩니다.
- 병합: 가져온 콘텐츠를 기존 버전 콘텐츠와 결합합니다. API 이름과 버전 식별자는 유지됩니다. 가져온 요소의 이름이 기존 요소와 동일한 경우 가져온 요소의 이름이 _merge 접미사로 변경됩니다(예: User_merge). 중복된 기본 URL 및 미디어 유형은 건너뜁니다.
업데이트된 콘텐츠가 적용된 상태로 버전 편집기가 열립니다.