asp.net-web-api - ASP.NET Web-API 帮助-API 生成器？

Question

我想知道是否有人可以指出我应该使用哪个Web-Api 帮助生成器。

我找到了这篇文章，但它已经有一年的历史了，而且似乎已经过时了。

我认为 ApiExplorer 现在是Web API Help。

这篇文章还谈到了Swagger，它从一些演示中看起来好多了，看起来你可以像发布请求之类的那样做，但我不确定它是否仍在开发中，因为自上次更新以来已经过去了一年。

有人对他们有任何经验吗？

Answer 1

“Web API 帮助页面”包 (Microsoft.AspNet.WebApi.HelpPage) 构建在 ApiExplorer 之上。

• Web API 帮助页面生成文档页面并将它们添加到您的项目中。
• ApiExplorer 为您提供了一个较低级别的 API，它只为您提供 API 描述，您可以使用它来创建文档。

见：http ://www.asp.net/web-api/overview/creating-web-apis/creating-api-help-pages

我没用过 Swagger。从自述文件中，它也构建在 ApiExplorer 之上。