Номер версии рекомендуется указывать целым числом, без точек; перед номером версии рекомендуется добавлять символ "v".
Рекомендуемым подходом является явное указание версии API в адресе API запроса - api.example.com/v1/showrooms/2345
Также можно передавать номер версии параметром в запросе - api.example.com/showrooms/2345?version=v1