Երբ պետք է բարձրացնենք API-ի պատասխանների տարբերակը և երբ ոչ?

API-ի տարբերակը պետք է բարձրացվի, երբ կատարվում են փոփոխություններ, որոնք խախտում են հետադարձ համատեղելիությունը (breaking changes): Այդ փոփոխությունները ներառում են՝

• Ներկառուցված կամ վերանվանված դաշտեր պատասխանում:
• Դաշտերի տվյալների տիպի փոփոխություն:
• Պատասխանային կառուցվածքի փոփոխություն, որը խանգարում է հաճախորդներին ճիշտ մշակել տվյալները:

Փոփոխություններ, որոնք չեն պահանջում տարբերակի բարձրացում:

• Նոր պարտադիր olmayan դաշտեր ավելացնել պատասխանում (հաճախորդները կարող են անտեսել դրանք):
• Նոր վերջնակետեր ավելացնել:
• Խնդիրների շտկում, որոնք չեն ազդում պատասխանների կառուցվածքի և ձևաչափի վրա:

Այսպիսով, եթե փոփոխությունները կարող են խանգարել առկա հաճախորդներին, անհրաժեշտ է բարձրացնել API-ի տարբերակը։