LessypskyANAА дайте ссылку на рекомендацию, если не сложно. Для меня это звучит как бред какой-то.

Выпускается новая версия, ставится на отдельные сервера, старая крутится на старых.
Клиенты постепенно переползают на новую. В итоге старая гасится.

https://docs.microsoft.com/en-us/azure/architecture/best-practices/api-design URI versioning

This versioning mechanism is very simple but depends on the server routing the request to the appropriate endpoint. However, it can become unwieldy as the web API matures through several iterations and the server has to support a number of different versions. Also, from a purist’s point of view, in all cases the client applications are fetching the same data (customer 3), so the URI should not really be different depending on the version. This scheme also complicates implementation of HATEOAS as all links will need to include the version number in their URIs.
...
Media type versioning

This approach is arguably the purest of the versioning mechanisms and lends itself naturally to HATEOAS, which can include the MIME type of related data in resource links.

И где Вы тут увидели про множество версий контроллеров?

the server has to support a number of different versions - это что-ли?

Дак это про то, что на сервере должно быть развёрнуто несколько версий приложения, пока клиенты пользуются и старыми и новыми версиями.

Походу топик родился из-за трудностей перевода

LessypskyANAИ где Вы тут увидели про множество версий контроллеров?

the server has to support a number of different versions - это что-ли?

Дак это про то, что на сервере должно быть развёрнуто несколько версий приложения, пока клиенты пользуются и старыми и новыми версиями.
там описание принципов, реализация тут:

https://github.com/Microsoft/aspnet-api-versioning/wiki/How-to-Version-Your-Service
Принципов чего?

Там написано: "Unfortunately, this causes an issue for service API versioning if you want split the implementation across different types ."

Вы хотите разнести реализацию по разным типам? Зачем?

LessypПотому-что так там написано. В общем как я понимаю опыта в реализации даного подхода у вас нет. Интересует мнение тех, у кого он есть
Данного нет. У нас иначе.