Sobes.tech
Middle

Kādās API atbildes izmaiņās mums jāpaaugstina versija un kad nē?

sobes.tech AI

Atbilde no AI

API versiju vajadzētu palielināt, veicot izmaiņas, kas pārtrauc atpakaļsaderību (breaking changes). Šādas izmaiņas ietver:

  • Esošo lauku dzēšanu vai pārsaukšanu atbildē.
  • Lauku datu tipa maiņu.
  • Atbildes struktūras maiņu, kas neļauj klientiem pareizi apstrādāt datus.

Izmaiņas, kurām nav nepieciešams palielināt versiju:

  • Jaunu izvēles lauku pievienošanu atbildē (klienti tos var ignorēt).
  • Jaunu galapunktu pievienošanu.
  • Kļūdu labošanu, kas neietekmē atbildes struktūru un formātu.

Tādēļ, ja izmaiņas var sabojāt esošos klientus, ir nepieciešams palielināt API versiju.