ASP.NET Core Web Api 自动帮助页面

ASP.NET Core Web Api automatic help pages

在ASP.NET之前的版本中,当我创建Web Api 2时,visual studio自动为API自动生成文档。

这里也有说明: http://www.asp.net/web-api/overview/getting-started-with-aspnet-web-api/creating-api-help-pages

我正在编写一个新项目,我决定使用 ASP.NET Core 来完成它,但我没有看到任何与从 API(我也猜这有点不同,因为所有控制器现在都继承自相同的 Controller class)。

但是,有什么方法可以为 ASP.NET Core API 生成帮助文件吗?

您想要的功能在 https://github.com/domaindrivendev/Swashbuckle

以下link提供了如何配置和使用精心设计的实用程序的示例 https://damienbod.com/2015/12/13/asp-net-5-mvc-6-api-documentation-using-swagger/

John Davidson 很好地post 展示了如何生成 Swagger 文档 - 这很有用而且很棒。

但是如果你想坚持使用 ASP.Net MVC 5 - Api Explorer 文档, 你应该看看那个优秀的博客 post:

https://andrewlock.net/introduction-to-the-apiexplorer-in-asp-net-core/