При кои промени в отговора на API трябва да увеличим версията и при кои не?

Версионността на API трябва да се увеличава при извършване на промени, които нарушават обратната съвместимост (breaking changes). Тези промени включват:

• Премахване или преименуване на съществуващи полета в отговора.
• Промяна на типа данни на полетата.
• Промяна на структурата на отговора, което пречи на клиентите да обработват правилно данните.

Промени, които не изискват увеличаване на версията:

• Добавяне на нови по избор полета в отговора (клиентите могат да ги игнорират).
• Добавяне на нови крайни точки.
• Коригиране на грешки, които не влияят на структурата и формата на отговора.

Следователно, ако промените могат да нарушат съществуващите клиенти, трябва да увеличите версията на API.