.net core 3.0_webapi项目使用Swagger提供接口帮助页面
前言:我们开发了很多的接口后,为了方便调用人员使用,需要给出接口地址,参数和解释说明,可能还需要示例。 那么swagger这个开源项目,已经给我们提供好了一整套的解决方案: 本博客参考文档: Swashbuckle 和 ASP.NET Core 入门 什么是 Swagger/OpenAPI? Swagger 是一个与语言无关的规范,用于描述 REST API。 Swagger 项目已捐赠给 OpenAPI 计划 ,现在它被称为开放 API。 这两个名称可互换使用,但 OpenAPI 是首选。 它允许计算机和人员了解服务的功能,而无需直接访问实现(源代码、网络访问、文档)。 其中一个目标是尽量减少连接取消关联的服务所需的工作量。 另一个目标是减少准确记录服务所需的时间。(说明参考微软官方文档: https://docs.microsoft.com/zh-cn/aspnet/core/tutorials/web-api-help-pages-using-swagger?view=aspnetcore-3.0 ) 快速添加webapi项目对swagger的支持: 1-添加程序包引用:Swashbuckle.AspNetCore -Version 5.0. 0-rc4 (该版本目前属于预览版,需要勾选预览版才可以看到) 2- 添加并配置 Swagger