0

我已下载并浏览到 Swagger-UI dist/index.html 文件，它已加载示例 Petstore API。但是，我无法弄清楚某些功能是如何运作的，因此无法将其带到我自己的定义中。

  1. 示例 Petstore 在右下角显示了一个“VALID {...}”按钮。但是，当我导航到自己的 API 定义时，我看不到这一点。如何启用它？
  2. 当我查看 Swagger-UI 呈现的 petstore API 规范时，http://petstore.swagger.io/v2/swagger.json我无法弄清楚它们是如何插入 Swagger Petstore 描述下方的部分的。

Contact the developer 这是一个带有电子邮件地址和主题行的 mailto 链接

Find out more about Swagger http://swagger.io既没有出现在 petstore json 定义中，也没有出现在我正在使用的定义中。

样品是从哪里提取的？

  1. 当我使用 Swagger 编辑器时，它以不同的方式解释规范 - 最重要的是适当地展示terms of use和license信息。Swagger-UI 不支持这些属性吗？我是否需要在 Swagger-UI 中启用某些东西才能使它们出现？
4

1 回答 1

0

您需要使用最新版本的 Swagger，至少Swagger Core 1.5 ，才能在您自己的 Swagger 项目中拥有这些简洁的功能。

  1. 版本 > 2.0 的 UI 带有内置的模式验证（页面底部的 VALID 按钮）。

2+3。Info 对象Contact the developer包含UI 渲染、许可和“更多信息”链接所需的所有信息。

于 2016-02-03T12:08:12.507 回答