API Versioning (ARCH6202)

Key ruby.quality.api-versioning · Severity info · Category quality

Unversioned public API routes make it impossible to ship backward-incompatible changes without breaking clients; the version should be explicit in the path.

Incorrect

Rails.application.routes.draw do
  resources :orders
  resources :users
end

Correct

Rails.application.routes.draw do
  namespace :v1 do
    resources :orders
    resources :users
  end
end

Fix

Group routes under an explicit version namespace (e.g. /v1) so future breaking changes can run side by side.