Wersjonowanie API dla tras Rails

Kilka rzeczy do dodania:

Twoje dopasowanie przekierowań nie zadziała na określone trasy - param *api jest chciwy i pochłonie wszystko, np. /api/asdf/users/1 przekieruje na /api/v2/1. Lepiej używaj zwykłego param jak :api. Co prawda nie będzie pasować do przypadków takich jak /api/asdf/asdf/users/1, ale jeśli masz zagnieżdżone zasoby w swoim api, jest to lepsze rozwiązanie.

Ryan WHY U NO LIKE namespace? :- ), np.:

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

Który ma dodatkową zaletę wersji i nazw rodzajowych trasy. Jedna dodatkowa uwaga-przy użyciu :module należy używać notacji podkreślenia, np.: api/v1, a nie 'Api:: V1'. W pewnym momencie Ten ostatni nie działał, ale wierzę, że został naprawiony w Rails 3.1.

Również, gdy wydasz v3 swojego API, trasy będą aktualizowane w następujący sposób:

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

Oczywiście jest prawdopodobne, że Twoje API ma różne trasy między wersjami, w takim przypadku możesz to zrobić:

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

Jeśli to w ogóle możliwe, sugerowałbym ponowne przemyślenie adresów URL, aby wersja nie była w adresie url, ale została umieszczona w nagłówku accepts. Ta odpowiedź na przepełnienie stosu idzie do niego dobrze:

Najlepsze praktyki dotyczące wersjonowania API?

A ten link pokazuje dokładnie jak to zrobić z trasowaniem rails:

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

Nie jestem wielkim fanem wersjonowania po trasach. Zbudowaliśmy VersionCake , aby wspierać łatwiejszą formę wersjonowania API.

Dodając numer wersji API w nazwie pliku każdego z naszych widoków (JBuilder, RABL, itp.), zachowujemy ich wersje dyskretne i umożliwiamy łatwą degradację w celu wsparcia wstecznej kompatybilności(np. jeśli v5 widoku nie istnieje, renderujemy V4 widoku).

Nie jestem pewien, dlaczego chcesz przekierować do określonej wersji, jeśli wersja nie jest wyraźnie wymagane. Wygląda na to, że po prostu chcesz zdefiniować domyślną wersję, która będzie serwowana, jeśli żadna wersja nie jest wyraźnie wymagana. Zgadzam się również z Davidem Bockiem, że utrzymywanie wersji poza strukturą URL jest czystszym sposobem wspierania wersjonowania.

Shameless plug: Versionist wspiera te przypadki użycia (i nie tylko).

Https://github.com/bploetz/versionist

Odpowiedź Ryana Bigga zadziałała.

Jeśli chcesz również zachować parametry zapytania poprzez przekierowanie, możesz to zrobić w następujący sposób:

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