Verzování API

Verze je v adrese: /v1/. Když vydáme /v2/, v1 zůstane běžet nejméně 12 měsíců.

Co je zpětně kompatibilní

• přidání nového pole do odpovědi,
• přidání nového volitelného parametru,
• nový endpoint.

To se může stát kdykoli a klienta to nesmí rozbít.

Co je nová verze

• odebrání pole, změna typu, změna významu,
• změna chování u existujícího endpointu.

O takové změně dáme vědět e-mailem a v změnách ve službě.