2

Всем привет, подскажите, как правильно вести версии апи на уровне логики. Использую ASP.NET Core, Библиотеку MediatoR, подход CQRS и проект на чистой архитектуре.

На уровне контроллеров у меня выглядит так и все понятно.

[ApiVersion("2.0")]
[ApiExplorerSettings(GroupName = "v2")]
public class CalculationsController : WebApiControllerBase
{
    [Obsolete]
    [HttpPost]
    [SwaggerResponse(StatusCodes.Status200OK, "200", typeof(Response<IEnumerable<ProductResponseBase>>))]
    public async Task<IActionResult> Get([FromBody] GeneralProductQuery request)
    {
        return Json(await Mediator.Send(request));
    }

    [HttpPost]
    [MapToApiVersion("2.1")]
    [SwaggerResponse(StatusCodes.Status200OK, "200", typeof(Response<GeneralProductResponseV2_1>))]
    public async Task<IActionResult> GetV2_1([FromBody] GeneralProductQueryV2_1 request)
    {
        return Json(await Mediator.Send(request));
    }
}

На уровне приложения вышло так

введите сюда описание изображения

И не понимаю, правильно ли организовываю версионность, что дописываю версии в имена классов или в методах каких-то сервисов? Так и реализовывают API сервисы или есть другой подход?

2
  • Можно версии сделать пространствами имён. Тогда имена классов и методов можно оставлять теми же в новых версиях. 11 мар 2021 в 15:42
  • Лично мне оказалась очень полезной книга Modern API Design with ASP.NET Core 2, Fanie Reynders. Глава 9, раздел Versioning. Рекомендую к ознакомлению. 11 мар 2021 в 15:44

0

Ваш ответ

Нажимая на кнопку «Отправить ответ», вы соглашаетесь с нашими пользовательским соглашением, политикой конфиденциальности и политикой о куки

Посмотрите другие вопросы с метками или задайте свой вопрос.