2.2. OpenAPI 规格 2.0 使用 3scale

您可以添加 OAS 2.0 规格到 ActiveDocs 中,并在 Developer Portal 中显示它们,考虑以下几点:

  • 您必须手动升级模板。
  • ActiveDoc 没有额外的功能,如尝试请求时使用凭证注入和自动完成功能,如服务名称等实际数据。

对 OAS 2.0 规格的支持需要在默认文档页面中提供以下内容:

<h1>Documentation</h1>
{% cdn_asset /swagger-ui/2.2.10/swagger-ui.js %}
{% cdn_asset /swagger-ui/2.2.10/swagger-ui.css %}

{% include 'shared/swagger_ui' %}

<script type="text/javascript">
  $(function () {
    window.swaggerUi.options['url'] = "{{provider.api_specs.first.url}}";
    window.swaggerUi.load();
  });
</script>