"Методические рекомендации по публикации открытых данных государственными органами и органами местного самоуправления, а также технические требования к публикации открытых данных. Версия 3.0" (утв. протоколом заседания Правительственной комиссии по...

Как реализовывать версионность API?

Номер версии рекомендуется указывать целым числом, без точек; перед номером версии рекомендуется добавлять символ "v".

Рекомендуемым подходом является явное указание версии API в адресе API запроса - api.example.com/v1/showrooms/2345

Также можно передавать номер версии параметром в запросе - api.example.com/showrooms/2345?version=v1

Версионность API Постраничный ответ