Versionado de API para Rutas Rails

Un par de cosas a añadir:

Su coincidencia de redireccionamiento no va a funcionar para ciertas rutas: el parámetro *api es codicioso y se tragará todo, por ejemplo, /api/asdf/users/1 se redirigirá a /api/v2/1. Sería mejor usar un param regular como :api. Es cierto que no coincidirá con casos como /api/asdf/asdf/users/1, pero si tiene recursos anidados en su api, es una mejor solución.

Ryan ¿POR QUÉ NO ME GUSTA namespace? :- ), por ejemplo:

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

Que tiene el beneficio añadido de versionado y genérico nombrado ruta. Una nota adicional - la convención cuando se usa :module es usar notación de subrayado, por ejemplo: api/v1 no 'Api::V1'. En un momento este último no funcionó, pero creo que se arregló en Rails 3.1.

Además, cuando publiques la v3 de tu API, las rutas se actualizarán de la siguiente manera:

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

Por supuesto, es probable que su API tenga diferentes rutas entre las versiones, en cuyo caso puede hacer esto:

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

Si es posible, sugeriría repensar sus url para que la versión no esté en la url, sino que se coloque en el encabezado accepts. Esta respuesta de desbordamiento de pila va bien:

¿Mejores prácticas para el control de versiones de API?

Y este enlace muestra exactamente cómo hacerlo con el enrutamiento de rails:

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

No soy un gran fan del versionado por rutas. Construimos VersionCake para soportar una forma más fácil de versionado de API.

Al incluir el número de versión de la API en el nombre de archivo de cada una de nuestras vistas respectivas (jbuilder, RABL, etc.), mantenemos el control de versiones discreto y permitimos una degradación fácil para soportar la compatibilidad hacia atrás (por ejemplo, si v5 de la vista no existe, renderizamos v4 de la vista).

No estoy seguro de por qué desea redirigir a una versión específica si una versión no se solicita explícitamente. Parece que simplemente desea definir una versión predeterminada que se muestre si no se solicita ninguna versión explícitamente. También estoy de acuerdo con David Bock en que mantener las versiones fuera de la estructura de URL es una forma más limpia de soportar el control de versiones.

Shameless plug: Versionist soporta estos casos de uso (y más).

Https://github.com/bploetz/versionist

Ryan Bigg answer trabajó para mí.

Si también desea mantener los parámetros de consulta a través de la redirección, puede hacerlo así:

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