Pri akých zmenách odpovede API by sme mali zvyšovať verziu a pri ktorých nie?

Verzia API by mala byť zvýšená pri vykonávaní zmien, ktoré narušujú spätnú kompatibilitu (breaking changes). Tieto zmeny zahŕňajú:

• Odstránenie alebo premenovanie existujúcich polí v odpovedi.
• Zmenu dátového typu polí.
• Zmenu štruktúry odpovede, čo znemožní klientom správne spracovať údaje.

Zmeny, ktoré nevyžadujú zvýšenie verzie:

• Pridanie nových voliteľných polí do odpovede (klienti ich môžu ignorovať).
• Pridanie nových koncových bodov.
• Opravu chýb, ktoré neovplyvňujú štruktúru a formát odpovede.

Akékoľvek zmeny, ktoré môžu narušiť existujúcich klientov, je potrebné zvýšiť verziu API.