[Asp.Net Core]ASP.NET Core WebApi使用Swagger生成api说明文档看这篇就够了

引言

在使用asp.net core 进行api开发完成后，书写api说明文档对于程序员来说想必是件很痛苦的事情吧，但文档又必须写，而且文档的格式如果没有具体要求的话，最终完成的文档则完全取决于开发者的心情。或者详细点，或者简单点。那么有没有一种快速有效的方法来构建api说明文档呢？答案是肯定的， Swagger就是最受欢迎的REST APIs文档生成工具之一！

为什么使用Swagger作为REST APIs文档生成工具

1. Swagger 可以生成一个具有互动性的API控制台，开发者可以用来快速学习和尝试API。 Swagger
2. 可以生成客户端SDK代码用于各种不同的平台上的实现。
3. Swagger 文件可以在许多不同的平台上从代码注释中自动生成。
4. Swagger 有一个强大的社区，里面有许多强悍的贡献者。

asp.net core中如何使用Swagger生成api说明文档呢

1. Swashbuckle.AspNetCore 是一个开源项目，用于生成 ASP.NET Core Web API 的 Swagger文档。
2. NSwag 是另一个用于将 Swagger UI 或 ReDoc 集成到 ASP.NET Core Web API中的开源项目。 它提供了为 API 生成 C# 和 Typ