API yanıtında hangi değişikliklerde versiyonu yükseltmeliyiz ve hangi değişikliklerde yükseltmemeliyiz?

De API sürümünü, geri uyumluluğu bozan (kırıcı değişiklikler) değişiklikler yapıldığında artırmalısınız. Bu değişiklikler şunları içerir:

• Yanıtta mevcut alanların silinmesi veya yeniden adlandırılması.
• Alanların veri tipinin değiştirilmesi.
• Yanıt yapısının değiştirilmesi, bu da müşterilerin verileri doğru şekilde işleyememesine neden olur.

Sürüm artırmayı gerektirmeyen değişiklikler:

• Yanıta yeni isteğe bağlı alanlar eklemek (müşteriler bunları görmezden gelebilir).
• Yeni uç noktalar eklemek.
• Yanıtın yapısını ve formatını etkilemeyen hataları düzeltmek.

Bu nedenle, değişiklikler mevcut müşterileri bozabilecekse, API sürümünü artırmanız gerekir.