在其他网站上托管 Swashbuckle 文档答案

【问题标题】：Host Swashbuckle documentation on other Web site在其他网站上托管 Swashbuckle 文档
【发布时间】：2016-07-12 17:26:43
【问题描述】：

我在 IIS 下托管了启用 Web-API 的应用程序。我在其中添加了 Swashbuckle，一切似乎都运行良好。我可以通过 api.cooldomain.com/swagger/ui/index 访问 Swashbuckle 文档

是否可以在另一个网站上托管 Swashbuckle 文档？（API 在 api.cooldomain.com 上运行，我想在 docs.cooldomain.com 上获得 Swashbuckle 文档？

【问题讨论】：

没有理由不能只拥有一个指向托管 Swagger 文档位置的 DNS 条目。
是的，我可以有一个 DNS 条目指向托管 API 的同一个网站（以及 Swashbuckle 文档）。在这种情况下，可以通过 docs.cooldomain.com/api/{controller}/{method} 访问 API 我希望有一个仅托管文档的网站。

【解决方案1】：

Swashbuckle 将您的 swagger API 清单 JSON 文档托管在：

[您的 url 根]/swagger/docs/[版本，例如v1]

托管在 /swagger 的 swashbuckle index.html 实际上只是下载这个 JSON 文档并使用它来填充页面。

你不能在你的 API 项目上启用 swagger UI（但仍然启用 swagger），然后在任何地方从 Swashbuckle 托管 index.html 文件（它在他们的仓库中：Swagger-UI。

您可以让它指向 API 站点上的 swagger 清单进行渲染。

【讨论】：