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" %} Liquid 태그의 존재 여부에 따라 달라집니다. 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" %}유동 태그를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' %}{% cdn_asset /swagger-ui/2.2.10/swagger-ui.js %} {% cdn_asset /swagger-ui/2.2.10/swagger-ui.css %} {% include 'shared/swagger_ui' %}Copy to Clipboard Copied! Toggle word wrap Toggle overflow 선택 사항: 기본적으로 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}}";window.swaggerUi.options['url'] = "{{provider.api_specs.<SPEC_SYSTEM_NAME>.url}}";Copy to Clipboard Copied! Toggle word wrap Toggle overflow