我正在为以dotnet核心编写的API添加新版本。 较旧的版本存在一些设计缺陷,而2.0版将与1.0版完全不同。 v1的API文档所有我在v2.0中实现的方法,尚不清楚是否有人要使用该文档。 我可以添加任何属性来解决此问题吗?
示例
// Version 1
namespace WebApiSwaggerVersion.Controllers.V1
{
[ApiController]
[ApiVersion("1")] // should not show the method getPath in documentation for version 2
[Route("api/v1/[controller]")]
public class VersionOneObsoleteController : ControllerBase
{
[HttpGet("getwrongFile")]
Action mymethod() {...}
}
}
// Version 2
namespace WebApiSwaggerVersion.Controllers.V2
{
[ApiController]
[Route("api/v2/[controller]")]
{
[HttpGet("correctRoute")]
Action mymethod() {...}
}
}