一.新建项目: dotnet new mvc -n SwaggerTest
二.添加nuget引用 :dotnet add TodoApi.csproj package Swashbuckle.AspNetCore -v 5.0.0
也可以使用 Package Manager Console
三.Startup中的ConfigureServices 添加服务
services.AddSwaggerGen(c => { c.SwaggerDoc("v1", new Microsoft.OpenApi.Models.OpenApiInfo { Title = "Docs", Version = "V1" }); });
四.在Startup中的Configure使用 代码如下
app.UseSwagger(); app.UseSwaggerUI(c=>c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1"));
五.在HomeController添加如下代码
public class HomeController : Controller { /// <param name="name"></param> [HttpPost("{name}")] public IActionResult Find(string name) { if (string.IsNullOrWhiteSpace(name)) return NotFound(); else return Content(name); } }
六.测试