API Sürümleme (ARCH6202)

Anahtar ruby.quality.api-versioning · Önem info · Kategori quality

Sürümlenmemiş genel API rotaları, geriye dönük uyumsuz değişiklikleri istemcileri bozmadan yapmayı imkânsız hâle getirir; sürüm yola açıkça eklenmelidir.

Hatalı

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

Doğru

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

Düzeltme

Rotaları açık bir sürüm ad alanının (örneğin /v1) altında gruplayarak gelecekteki kırıcı değişiklikleri yan yana çalıştırın.