Swagger 入门

Swagger 可以生成api文档，也可以调用api

以asp.net webapi 项目为例

1 使用nuget搜索“Swashbuckle” 安装 Swagger 引用

2 安装成功后会在项目App_Start下自动生成SwaggerConfig.cs文件

 

3 项目生成xml文档，然后在SwaggerConfig中启用xml文档：

 

 在SwaggerConfig添加如下代码：

c.IncludeXmlComments(string.Format("{0}/bin/SwaggerApi.xml", System.AppDomain.CurrentDomain.BaseDirectory));

 

 4 在一个api方法添加xml说明

 

 

5 查看api文档

在启动的url后面添加 /Swagger 就行，然后在弹出的新的页面中点击“Show/Hide”展开

 

 

 

 

6 发送请求调用api