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

Три подхода. URL path: /api/v1/users, /api/v2/users — самый популярный, простой, хорошо кешируется. Header: Accept: application/vnd.myapi.v2+json — чище по REST, но сложнее тестировать в браузере. Query param: /users?version=2 — не рекомендуется. В Go обычно URL path: разные роутеры на /v1 и /v2, общие хэндлеры переиспользуются. Не версионируй каждый эндпоинт отдельно — версия на весь API. И не плоди версии — лучше обратно совместимые изменения.