WebApi & Swagger

Swagger简介

Swashbuckle 是一个开源项目，为使用 ASP.NET Core MVC 构建的 Web APIs 生成 Swagger 文档。

Swagger 是一个机器可读的 RESTful API 表现层，它可以支持交互式文档、客户端 SDK 的生成和可被发现

Swashbuckle 有两个核心的组件

 

Swashbuckle 有两个核心的组件

Swashbuckle.SwaggerGen : 提供生成描述对象、方法、返回类型等的 JSON Swagger 文档的功能。

Swashbuckle.SwaggerUI : 是一个嵌入式版本的 Swagger UI 工具，使用 Swagger UI 强大的富文本表现形式来可定制化的来描述 Web API 的功能，并且包含内置的公共方法测试工具。

 

 在VS2017中创建并使用Swagger

1. 创建一个WebApi的Asp.Net应用程序

 2. 使用“Nuget包管理器”搜索“Swashbuckle”安装即可

 3. 然后更改项目属性“Xml文档文件”

 

 4. 使用Swagger：启动项目，然后在地址栏输入“http://localhost:49245/swagger/ui/index#/Login”

5.Swagger配置(后续更上)