Kokiais API atsakymo pakeitimais turėtume didinti versiją ir kokiais ne?

API versiją reikia didinti, kai atliekami pakeitimai, kurie pažeidžia atgalinį suderinamumą (breaking changes). Tokie pakeitimai apima:

• Esamų laukų šalinimą arba pervadinimą atsakyme.
• Laukų duomenų tipo keitimą.
• Atsakymo struktūros keitimą, kuris neleidžia klientams teisingai apdoroti duomenų.

Pakeitimai, kurie nereikalauja versijos didinimo:

• Naujų neprivalomų laukų pridėjimą atsakyme (klientai gali juos ignoruoti).
• Naujų galinių taškų pridėjimą.
• Klaidos taisymą, kurios nepaveikia atsakymo struktūros ir formato.

Todėl, jei pakeitimai gali sugadinti esamus klientus, reikia padidinti API versiją.