ASP.NET Core Swagger 是一个用于自动生成 API 文档的工具,它可以帮助开发人员更好地理解和使用 API。要处理请求,您需要遵循以下步骤:
dotnet add package Swashbuckle.AspNetCore
Startup.cs
文件中,您需要配置 Swagger 以便它能够扫描您的控制器并生成文档。在 ConfigureServices
方法中添加以下代码:services.AddSwaggerGen(c =>
{
c.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "v1" });
});
在 Configure
方法中添加以下代码:
app.UseSwagger();
app.UseSwaggerUI(c =>
{
c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
});
ValuesController
的控制器:using Microsoft.AspNetCore.Mvc;
[ApiController]
[Route("api/[controller]")]
public class ValuesController : ControllerBase
{
[HttpGet("{id}")]
public ActionResult<string> Get(int id)
{
return "Value: " + id;
}
[HttpPost]
public ActionResult<string> Post([FromBody] string value)
{
return "Value created: " + value;
}
}
访问 Swagger 文档:启动应用程序后,您可以通过访问 http://localhost:端口号/swagger
来查看生成的 Swagger 文档。在这里,您可以看到您的控制器和 API 方法,以及它们的请求和响应示例。
测试 API:您可以通过 Swagger UI 中的“Try it out”按钮测试您的 API 方法。这将发送一个实际请求到您的 API,并显示响应结果。
通过以上步骤,您可以在 ASP.NET Core 项目中使用 Swagger 处理请求并自动生成 API 文档。