Change decision

API 변경 방식 판단 기준

새 버전이 필요한지 판단하려면 기존 클라이언트가 같은 요청으로 같은 의미의 응답을 받을 수 있는지 먼저 본다.

버전 또는 진화
기존 버전에서 진화

선택 필드 추가, 새 정렬 옵션, 새 엔드포인트처럼 기존 클라이언트가 깨지지 않는 변경.

optional fieldnew endpointcompatible default
새 버전 필요

필수 필드 추가, 응답 의미 변경, 인증 방식 변경, 상태 코드 계약 변경처럼 기존 동작을 깨는 변경.

required fieldremoved responseauth change
판단이 애매하면 실제 사용 로그와 클라이언트 영향 범위를 보고 마이그레이션 기간을 먼저 설계한다.