Как правильно назвать обновленный запрос в бэкенде?

Question

[Anrek]

Добрый день!

У меня уже есть работающий GET запрос "/product/search".
Но во второй версии бэкенда я много чего поменял и хочу и старый оставить чтобы отвечал клиентам со старой версией и добавить новый с таким же смыслом, но в целом другой.

Вопрос: годится ли версию№2 запроса назвать что-то вроде "/product/search/new" ? или есть ли какие-то принятые соглашения как в таком случае запросы помечать? Что это вот новая версия - а старый с аналогичным названием можно будет просто удалить через некоторое время?

Answer 1

[Алексей Уколов]

Правильно назвать его, например, /api/v2/product/search/, чтобы у вас уже была встроенная схема версионирования и в будущем вы над этим не думали.

Однако, если клиенты находятся под вашим контролем, то можно назвать как угодно.