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에 대한 지원이 도입되면서 구현 방법이 multiple cdn_asset 로 변경되어 유동 태그가 포함됩니다.

참고

Swagger UI 2.1.3 이전 버전의 경우 3scale은 레거시 active_docs 유동 태그 방법을 사용하여 UI를 호출합니다.

사전 요구 사항

  • 관리자 액세스 권한이 있는 3scale 인스턴스.
  • Swagger UI 2.1.3을 포함하는 3scale 인스턴스.

절차

  1. 3scale 관리 포털에 로그인합니다.
  2. 개발자 포털문서 페이지로 이동하거나 Swagger UI 구현을 업데이트할 페이지로 이동합니다.
  3. 코드 창의 Draft 탭에서 {% active_docs 버전을 교체합니다. "2.0" %} cdn_asset 유동 태그 및 새로운 부분 공유/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' %}
  4. 선택 사항: 기본적으로 Swagger UI는 API > ActiveDocs에 게시된 ActiveDocs 사양을 로드합니다. window. swaggerUi. load(); 행 앞에 다음 window.swaggerUi. options 행을 추가하여 다른 사양을 로드합니다. 여기서 <SPEC_SYSTEM_NAME> 은 로드하려는 사양의 시스템 이름입니다.

    window.swaggerUi.options['url'] = "{{provider.api_specs.<SPEC_SYSTEM_NAME>.url}}";