Swagger单一交互式HTML

时间:2017-08-08 11:56:10

标签: documentation swagger swagger-ui swagger-codegen

我正在尝试使用试用按钮制作单个html。该 swagger-code gen和swagger-ui给了我那个结果。你有什么建议吗?

1 个答案:

答案 0 :(得分:5)

您可以尝试将Swagger UI更改为“一个大杂乱的HTML文件”,如下所示:

  1. 下载Swagger UI(link to the latest master)。

  2. 转到dist文件夹。

  3. 按如下方式修改index.html

    • 删除<link rel="stylesheet" type="text/css" href="./swagger-ui.css" >并将swagger-ui.css文件的内容粘贴到<style>元素中。

    • 替换

      <script src="./swagger-ui-bundle.js"> </script>
      <script src="./swagger-ui-standalone-preset.js"> </script>
      

      包含<script>...</script>swagger-ui-bundle.js代码的swagger-ui-standalone-preset.js元素。

    • 替换

      url: "http://petstore.swagger.io/v2/swagger.json",
      

      使用spec参数包含JSON格式的API规范,如下所示:

      spec: {
        "swagger": "2.0",
        "info": ...,
        "paths": ...
      },
      

      如果您的规范是YAML,请先将其转换为JSON,例如使用https://www.json2yaml.com

    • 删除favicon:<link rel="icon" type="image/png" href="./favicon-...

  4. 现在index.html可以用作独立文件。