一、代码操作步骤:
- 添加NuGet包:Swashbuckle.AspNetCore
- Startup类的ConfigureServices方法中添加以下代码:
services.AddSwaggerGen(c => { c.SwaggerDoc("v1", new Info { Title = "My API", Version = "v1" }); c.AddSecurityDefinition("Bearer", new ApiKeyScheme { In = "header", Description = "Please enter JWT with Bearer into field", Name = "Authorization", Type = "apiKey" }); c.AddSecurityRequirement(new Dictionary<string, IEnumerable<string>> { { "Bearer", Enumerable.Empty<string>() }, }); });
Configure方法中添加以下代码:
app.UseSwagger(); app.UseSwaggerUI(c => { c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1"); });
以上代码部分操作完成。运行项目,打开Swagger界面。
二、Swagger界面操作:
在界面的右上部分,会看到一个的一个按钮,点击后出现下面的界面:
输入登录后获取到的Token(包含前面的“Bearer ”)内容。点击“Authorize”,出现以下界面:
此时,通过Swagger调试其他API接口时,会自动把Token值加到Header中的“Authorization”属性中。点击“Close”即可继续调试测试其他API。