Версионирование Web API?

Question

[Михаил Иванов]

Разрабатываю Web API с использованием ASP.NET MVC.
Предположим, со временем понадобится добавить в API новый метод. Получается, что все остальные методы - V1, а новый - V2. Мне не понятно как пользователь будет обращаться к API. Что будет, если он запросит метод V1 с url, соответствующим V2.
Например: в версии 1 есть сущность audio и пользователи могут работать с ней по адресу api.com/v1/audio. Во второй версии я решаю добавить видео (api.com/v2/video). Что будет, если пользователь запросит v2/audio?
Возможно я неправильно себе представляю процесс версионирования. Если так, поясните, пожалуйста, как правильно.

Answer 1

[sisn]

Например: в версии 1 есть сущность audio и пользователи могут работать с ней по адресу api.com/v1/audio. Во второй версии я решаю добавить видео (api.com/v2/video). Что будет, если пользователь запросит v2/audio?

Если вы исходите из того, что V2 включает ТОЛЬКО ДОПОЛНЕНИЯ к V1, то по /v2/audio вы должны отдавать ошибку