ASP.NET Core简单使用Swagger

Swagger简单说就是一个API生成工具。解决了程序员手写API文档的痛处。废话不多说，直接上代码。

一．首先建一个项目

 

 

 

二． 引入Swashbuckle.AspNetCore

 

 

三.配置 Swagger 中间件

将 Swagger 生成器添加到 Startup.ConfigureServices 方法中的服务集合中

 

 

 

Contact:代表作者的联系信息。

 

在 Startup->Configure 方法中，启用中间件为生成的 JSON 文档和 Swagger UI 提供服务

 

 

四.到这里基本已经搭建完成，我们运行看看效果

 

 

 

五．我们可以看到这些API都是没有注释的，我们现在来加入注释

 

 

 

注意上面生成xml的路径，接下来，我们来获取xml.

 

 

 

找个API我们去加上注释 ，方便看效果。

 

 

 

我们运行看看效果，所有注释都出来了。

 

 

 

最后我们来测试一个API调用。