当前位置: 首页 > 知识库问答 >
问题:

有可能获得一个网站的swagger文档的离线版本吗?

子车飞文
2023-03-14

LocalHost/Swagger的加载与我预期的一样,但RemoteServer/Swagger出现了问题。我是否可以保存生成的swagger文档的脱机副本?当我试图调试远程问题时,我可以只向几个用户发送一个zip文件

共有1个答案

姜阳
2023-03-14

如果您由于某种原因不能自己托管Swagger UI,有很多方法可以向您的用户提供API文档。所有建议都假设您有一个OpenAPI(Swagger)定义,即YAML/JSON文件。如果您不知道YAML/JSON文件的位置,可以从Swagger UI web页面中推断出它。

不分先后:

>

  • 向用户发送YAML/JSON文件,并告诉他们将其加载到http://editor.swagger.io以便预览API文档。

     http://petstore.swagger.io?url=YOUR_YAML_or_JSON_URL
    

    “打包”Swagger UI和OpenAPI定义到一个没有依赖关系的文件中,并将结果文件发送给用户。

    生成静态HTML文档(不是Swagger UI,而是一个没有“试用”的静态HTML页面):将OpenAPI定义加载到http://editor.Swagger.io中,然后选择菜单项Generate Client>HTML或html2或Dynamic-HTML。

    “generate Client”特性使用了Swagger Codegen,因此您也可以使用Codegen的CLI版本来生成所需的输出。

    • 用昂首阔步生成静态文档
    • 将Swagger规范JSON转换为HTML文档

  •  类似资料:
    • 本文档会不断地修订。请查阅 Debian 3.1 页面 以了解最近的关于 3.1 版 Debian GNU/Linux 系统的的信息。 更新的安装手册也可以从 官方安装手册页得到。

    • 本文档会不断地修订。请查阅 Debian 3.1 页面 以了解最近的关于 3.1 版 Debian GNU/Linux 系统的的信息。 更新的安装手册也可以从 官方安装手册页得到。

    • 我有一个Spring启动的MVC java网络应用程序。我已经能够为API留档集成Springfox。当服务器启动并运行时,我可以直观地看到所有的API。 我如何生成离线的swagger API文档?注意:我不想使用AsciDoc或markdown文档,但我希望在html文件中使用相同的swagger API用户界面。我希望链接是相对于本地目录的,而不是相对于本地主机服务器链接的。谢谢

    • 未能解析配置“:classpath”的所有工件。:无法解析com.android.tools.build:gradle:3.6.1。 由:org.gradle.internal.resolve.ModuleVersionResolveException引起:脱机模式下没有com.android.tools.build:gradle:3.6.1的缓存版本。 我将Android Studio升级到5.

    • 我创建了一个新网站,并添加了一个服务工作者。它安装了,但拒绝脱机工作。我通过指定所有的URL从缓存显式加载所有资源。有人能解释为什么主请求失败吗? 链接:http://ashutoshysingh.com/sw.js 更新1:我已经阅读了索引。缓存中的html文件。 Firefox控制台中显示错误: 未能加载'https://www.ashutoshysingh.com/“。一名服务人员向Fetc

    • solr search API调用将版本列表调整为仅20个。为什么?我们如何获得GAV合作伙伴发布的所有版本的列表。有API调用吗? https://search.maven.org/solrsearch/select?q=g:com.fasterxml.jackson.core和a: jackson-datind 你能帮我找到一个API,让我可以访问GAV坐标的所有版本及其发布日期吗? 谢谢