2.3. Swagger 사용자 인터페이스 2.1.3을 2.2.10으로 업그레이드
Swagger UI 2.1.3이 포함된 3scale 버전을 사용하는 경우 Swagger UI 버전 2.2.10으로 업그레이드할 수 있습니다.
3scale 개발자 포털에서 Swagger UI 2.1.3의 이전 구현은 문서 페이지의 단일 {% active_docs 버전: "2.0" %} 유동 태그의 존재에 따라 달라집니다. 3scale에서 Swagger 2.2.10 지원이 도입됨에 따라 구현 방법이 여러 cdn_asset 으로 변경되고 유동 태그를 포함합니다.
Swagger UI 2.1.3 이전 버전의 경우 3scale은 레거시 active_docs liquid 태그 메서드를 사용하여 UI를 호출합니다.
사전 요구 사항
- 관리자 액세스 권한이 있는 3scale 인스턴스.
- Swagger UI 2.1.3이 포함된 3scale 인스턴스입니다.
프로세스
- 3scale 관리 포털에 로그인합니다.
-
개발자 포털문서페이지 또는 Swagger UI 구현을 업데이트할 페이지로 이동합니다. 코드 창의
Draft탭에서{% active_docs 버전: "2.0" %}liquid 태그를cdn_assetliquid 태그와 새로운 부분공유/swagger_ui로 바꿉니다.{% cdn_asset /swagger-ui/2.2.10/swagger-ui.js %} {% cdn_asset /swagger-ui/2.2.10/swagger-ui.css %} {% include 'shared/swagger_ui' %}선택 사항: 기본적으로 Swagger UI는 API > ActiveDocs에 게시된 ActiveDocs 사양을 로드합니다. 창 앞에 다음
window.swaggerUi.options행을 추가하여 다른 사양을로드합니다. 여기서 <SPEC_SYSTEM_NAME>은 로드하려는 사양의 시스템 이름입니다.window.swaggerUi.options['url'] = "{{provider.api_specs.<SPEC_SYSTEM_NAME>.url}}";