asp.net-web-api - 是否可以在单独的项目中为 Asp Web Api 创建 Swagger 文档？

Question

是否可以在单独的项目中为我的 ASP.Net Web API 生成 Swagger 文档？

我创建了一个空项目，Swagger 文档应该放在其中。在 API 项目中，引用了 Swagger 项目，但没有工作。比 API 项目像外部程序集一样加载。控制器可访问，但未生成文档。

然后尝试使用自动生成的 XML 文档，只是看看它是否会创建任何东西，但没有结果。

在此之后，尝试在一个 Swagger 文档中包含多个 API，在一个 Swagger 文件中包含多个 API 文档，这是行不通的。

我也试过这个：

• 用于外部程序集中 WebAPI 控制器的 ApiExplorer
• https://github.com/Microsoft/aspnet-api-versioning/issues/271

在 Swagger 官方文档中，我没有找到可以帮助我解决这个问题的东西。如果可能以及需要如何完成，我也没有在其他地方找到任何信息。

我使用 Swashbuckle 5.6.0 和 ASP.Net Web API。

标签： asp.net-web-apiswaggerswashbuckle

Answer 1

是的，可以在单独的项目中为 Web API 生成 Swagger 文档。

在这里，我的代码显示了我是如何做到的：
https ://github.com/heldersepu/csharp-proj/tree/master/Swashbuckle.Sample

这是 swagger-ui 的样子： http ://swashbucklesample.azurewebsites.net/swagger/ui/index

老实说，该代码没有什么特别之处，它对我来说是第一次尝试......
但我确实有一些使用 Swashbuckle 的经验

如果您可以提供一个最小的项目来重现您的问题，我们可以帮助您一起深入了解它。