要在C# WebAPI項目中集成Swagger,可以按照以下步驟進行操作:
安裝Swashbuckle NuGet包:在Visual Studio中打開項目,右鍵單擊解決方案中的“項目”文件夾,選擇“管理NuGet程序包”。在NuGet程序包管理器中搜索“Swashbuckle”并安裝最新版本的Swashbuckle.AspNetCore包。
配置Swagger中間件:在Startup.cs文件中的ConfigureServices方法中添加以下代碼以啟用Swagger中間件:
services.AddSwaggerGen(c =>
{
c.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "v1" });
});
app.UseSwagger();
app.UseSwaggerUI(c =>
{
c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
});
[Route("api/[controller]")]
[ApiController]
public class ValuesController : ControllerBase
{
[HttpGet]
[ProducesResponseType(typeof(IEnumerable<string>), 200)]
public ActionResult<IEnumerable<string>> Get()
{
return new string[] { "value1", "value2" };
}
}
通過以上步驟,您可以在C# WebAPI項目中成功集成Swagger,并生成API文檔以便于查看和測試。