APIM'de barındırılan mevcut bir API'de küçük, bozucu olmayan güncellemeler yapmanız gerekiyor. Gereksinimler: Mevcut çağrı yapanları kesintiye uğratmayın, gerekirse değişiklikleri geri alabilin, geliştiriciler için değişiklikler hakkında dokümantasyon sağlayın ve yayınlamadan önce test yapılmasına izin verin. Ne yapmalısınız?

Mevcut API'de bozucu olmayan güncellemeler yaparken mevcut çağrı yapanları kesintiye uğratmamak, değişiklikleri geri alabilmek, geliştiricilere dokümantasyon sağlamak ve test imkanı sunmak için en uygun yöntem API'ye yeni bir revizyon eklemektir. Revizyonlar, API'nin farklı sürümlerini aynı URL altında yönetmenizi sağlar, böylece eski istemciler etkilenmezken yeni değişiklikler test edilebilir ve yayınlanabilir. Header veya Query string tabanlı versiyonlama, API'nin farklı sürümlerini farklı yollarla erişilebilir kılar ancak genellikle daha büyük, bozucu değişiklikler için kullanılır ve mevcut çağrı yapanları etkileme riski taşır. Bir ürün oluşturmak ve yayınlamak, API'nin kendisini değil, API'lerin bir koleksiyonunu veya erişim katmanını yönetir. Özel bir ilke yapılandırmak ise API'nin davranışını değiştirmek için kullanılır, sürüm yönetimi için uygun değildir.