【发布时间】：2019-05-29 06:05:47
【问题描述】：
所以我正在构建一个 Rest API 并使用一个 swagger YAML 文件来定义 API。
我使用 swagger 编辑器查看规范，但如何托管/让我们公司的每个人都可以浏览？
swagger 是否与实际部署的代码捆绑在一起，然后就可以访问了？
【问题讨论】：
【发布时间】：2019-05-29 06:05:47
【问题描述】：
您需要将它托管在某个地方。可以简单地作为可下载文件，也可以嵌入到应用程序中，例如Swagger UI。
【讨论】：
-
将其作为可下载文件而没有可视化表示将没有多大用处。因此，让每个最终用户拥有自己的 swagger 编辑器/UI 副本并不是一个好的解决方案。我希望规范将与 API 共同托管 - 这可能吗？
-
Swagger UI 是一个 Web 应用程序，因此您可以将其托管在公司服务器上。您还可以创建一个返回规范的端点，但您仍然没有视觉表示。