Swagger-ui - 无法弄清楚Petstore的某些功能是如何运作的

时间:2016-02-02 22:41:31

标签: swagger-ui swagger-2.0 swagger-editor

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

  1. 示例Petstore显示" VALID {...}"右下角的按钮。但是,当我导航到我自己的API定义时,我没有看到。我该如何启用它?
  2. 当我查找由Swagger-UI http://petstore.swagger.io/v2/swagger.json呈现的petstore API规范时,我无法弄清楚它们是如何插入Swagger Petstore描述下面的部分的。
  3. Contact the developer 这是一个包含电子邮件地址和主题行的mailto链接

    Find out more about Swagger http://swagger.io不会出现在petstore json定义或我正在使用的定义中。

    从哪个样本中挑选出来的?

    1. 当我使用Swagger编辑器时,它以不同的方式解释规范 - 最重要的是恰当地展示terms of uselicense信息。 Swagger-UI不支持这些属性吗?我是否需要在Swagger-UI中启用某些内容才能显示它们?

1 个答案:

答案 0 :(得分:0)

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

  1. 版本的用户界面> 2.0附带了架构验证(页面底部的VALID按钮)内置。
  2. 2 + 3。 The Info object包含用户界面呈现Contact the developer,许可和“更多信息”链接所需的所有信息。