asp.net core webapi 如何使用swagger，下面直入主題給出乾貨。
1、NuGet 安裝Swashbuckle.AspNetCore
2、Startup文件的ConfigureServices註冊swagger服務，重點是如何在頭部添加Bearer Token。
//註冊Swagger
services.AddSwaggerGen(c =>
{
c.SwaggerDoc("v1", new Microsoft.OpenApi.Models.OpenApiInfo() { Title = "Demo WebAPI", Version = "v1.0.0.1" });
//添加 Bearer Token 認證
c.AddSecurityDefinition("Bearer", new Microsoft.OpenApi.Models.OpenApiSecurityScheme
{
Description = "請輸入帶有Bearer的Token",
Name = "Authorization",
In = Microsoft.OpenApi.Models.ParameterLocation.Header,
Type = Microsoft.OpenApi.Models.SecuritySchemeType.ApiKey
});
c.AddSecurityRequirement(new OpenApiSecurityRequirement { { new OpenApiSecurityScheme { Reference = new OpenApiReference() { Id = "Bearer", Type = ReferenceType.SecurityScheme } }, Array.Empty<string>() } });/<string>
//顯示註釋
var xmlDocPath = Path.Combine(PlatformServices.Default.Application.ApplicationBasePath, "Demo.WebAPI.xml");
if (System.IO.File.Exists(xmlDocPath))
{
c.IncludeXmlComments(xmlDocPath);
}
});
3、Startup文件Configure配置swagger
app.UseSwagger();
app.UseSwaggerUI(c =>
{
c.SwaggerEndpoint("/swagger/v1/swagger.json", "Demo API V1");
});
4、添加一個UserController測試效果
/// <summary>
/// 測試
///
/// <returns>
[HttpGet]
[Route("Test")]
public string Test()
{
return Guid.NewGuid().ToString();
}
5、看看效果圖，你學會了嗎
asp.net core webapi swagger效果圖
閱讀更多 水調一方 的文章
關鍵字: xmlDocPath Microsoft Token
