რის დროს უნდა გავზარდოთ API-ის პასუხის ვერსია და როდის არა?

API ვერსიას უნდა გაზარდოთ, როდესაც ხორციელდება ცვლილებები, რომლებიც არღვევენ უკუგანვითარებას (breaking changes). ამ ცვლილებებში შედის:

• არსებული ველების წაშლა ან გადათარგმნა პასუხში.
• ველების მონაცემთა ტიპის შეცვლა.
• პასუხის სტრუქტურის შეცვლა, რაც ხელს უშლის მომხმარებლებს სწორად დამუშავებას.

ცვლილებები, რომლებიც არ მოითხოვს ვერსიის გაზრდას:

• ახალი სავალდებულო არამატერიალური ველების დამატება პასუხში (მომხმარებლებს შეუძლიათ იგნორირება).
• ახალი წერტილების დამატება.
• შეცდომების გამოსწორება, რომლებიც არ ზემოქმედებს პასუხის სტრუქტურასა და ფორმატზე.

ასე რომ, თუ ცვლილებები შეიძლება დააზიანოს არსებული მომხმარებლები, საჭიროა API ვერსიის გაზრდა.