U jakých změnách odpovědi API bychom měli zvyšovat verzi a u kterých ne?

Verze API by měla být zvýšena při provádění změn, které narušují zpětnou kompatibilitu (breaking changes). Tyto změny zahrnují:

• Odstranění nebo přejmenování stávajících polí v odpovědi.
• Změnu datového typu polí.
• Změnu struktury odpovědi, což znemožní klientům správně zpracovat data.

Změny, které nevyžadují zvýšení verze:

• Přidání nových volitelných polí do odpovědi (klienti je mohou ignorovat).
• Přidání nových koncových bodů.
• Opravu chyb, které neovlivňují strukturu a formát odpovědi.

Pokud změny mohou narušit stávající klienty, je třeba zvýšit verzi API.