1、首先引用nuget包:Swashbuckle.AspNetCore
我使用的是.net core 3.0的,需要引用的的nuget包是5.0預(yù)覽版的
添加中間件
services.AddSwaggerGen(c =>
{
c.SwaggerDoc("v1", new OpenApiInfo
{
Title = "Curry API",
Description = "API for Curry",
Version = "v1",
Contact = new OpenApiContact() { Name = "Curry", Email = "85232564@qq.com" }
});
var xmlPath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "Api.xml");
c.IncludeXmlComments(xmlPath);
});
使用
app.UseSwagger();
app.UseSwaggerUI(c =>
{
c.SwaggerEndpoint("/swagger/v1/swagger.json", "Curry V1");
});
為輸出xml配置路徑,以保證和我們使用的路徑一致倦零,這樣才能顯示出接口中的注釋文字
當(dāng)然我們在正式環(huán)境接口信息不宜暴露,可以通過環(huán)境變量來控制
隨便寫兩個接口測試下,運(yùn)行