Управление версиями API для маршрутов Rails

несколько вещей, чтобы добавить:

ваш редирект матч не будет работать для определенных маршрутов-the *api парам жаден и проглотит все, например /api/asdf/users/1 перенаправит к /api/v2/1. Вам было бы лучше использовать обычный парам, как :api. По общему признанию, это не будет соответствовать случаи, как /api/asdf/asdf/users/1 но если у вас есть вложенные ресурсы в вашем api, это лучшее решение.

Райан почему тебе не нравится namespace? :-), электронной.г:

current_api_routes = lambda do
  resources :users
end

namespace :api do
  scope :module => :v2, &current_api_routes
  namespace :v2, &current_api_routes
  namespace :v1, &current_api_routes
  match ":api/*path", :to => redirect("/api/v2/%{path}")
end

это преимущество версионных и универсальных именованных маршрутов. Еще одно примечание-конвенция при использовании :module использовать подчеркивание, например:api/v1 не 'Api:: V1'. В какой-то момент последний не работал, но я считаю, что это было исправлено в Rails 3.1.

кроме того, при выпуске v3 вашего API маршруты будут обновлены следующим образом:

current_api_routes = lambda do
  resources :users
end

namespace :api do
  scope :module => :v3, &current_api_routes
  namespace :v3, &current_api_routes
  namespace :v2, &current_api_routes
  namespace :v1, &current_api_routes
  match ":api/*path", :to => redirect("/api/v3/%{path}")
end

конечно, вполне вероятно, что ваш API имеет разные маршруты между версиями, и в этом случае вы можете сделать это:

current_api_routes = lambda do
  # Define latest API
end

namespace :api do
  scope :module => :v3, &current_api_routes
  namespace :v3, &current_api_routes

  namespace :v2 do
    # Define API v2 routes
  end

  namespace :v1 do
    # Define API v1 routes
  end

  match ":api/*path", :to => redirect("/api/v3/%{path}")
end

Если это вообще возможно, я бы предложил переосмыслить ваши URL-адреса, чтобы версия не была в url-адресе, а помещалась в заголовок accepts. Этот ответ переполнения стека входит в него хорошо:

рекомендации по управлению версиями API?

и эта ссылка показывает, как именно это сделать с маршрутизацией rails:

http://freelancing-gods.com/posts/versioning_your_ap_is

Я не большой поклонник версий по маршрутам. Мы построили VersionCake для поддержки более простой формы управления версиями API.

включив номер версии API в имя файла каждого из наших соответствующих представлений (jbuilder, RABL и т. д.), Мы сохраняем версию ненавязчивой и допускаем легкую деградацию для поддержки обратной совместимости (например, если v5 представления не существует, мы визуализируем v4 представления).

Я не уверен, почему вы хотите редирект к определенной версии, если версия не запрашивается явно. Похоже, вы просто хотите определить версию по умолчанию, которая обслуживается, если версия не запрашивается явно. Я также согласен с Дэвидом боком, что сохранение версий из структуры URL-это более чистый способ поддержки управления версиями.

бесстыдный плагин: Versionist поддерживает эти варианты использования (и более.)

https://github.com/bploetz/versionist

Райан Бигг ответ работал для меня.

Если вы также хотите сохранить параметры запроса через перенаправление, вы можете сделать это следующим образом:

match "*path", to: redirect{ |params, request| "/api/v2/#{params[:path]}?#{request.query_string}" }