Дар кадом тағйироти ҷавоби API бояд версияро баланд кунем ва дар кадом на?

Версияи API бояд дар вақти ворид кардани тағирот, ки мувофиқатнопазирии пасзаманро вайрон мекунанд (breaking changes), зиёд карда шавад. Ин тағиротҳо иборатанд аз:

• Ҳамон ё тағир додани номҳои майдонҳои мавҷуда дар ҷавоб.
• Тағйир додани намуди маълумоти майдонҳо.
• Тағйир додани сохтори ҷавоб, ки мизоҷонро дар коркарди дурустии маълумотҳо монеъ мешавад.

Тағйиротҳое, ки талаб намекунанд, ки версияи API зиёд карда шавад:

• Илова кардани майдонҳои нав, ки метавонанд интихобӣ бошанд (мизоҷон метавонанд онҳоро нодида гирад).
• Илова кардани нуқтаҳои охирӣ (эндпоинтҳо).
• Тазмини хатоҳо, ки сохтор ва формати ҷавобро таъсир намерасонанд.

Аз ин рӯ, агар тағиротҳо метавонанд мизоҷони мавҷударо вайрон кунанд, бояд версияи API-ро зиёд кард.