새 필드 추가
응답에 선택 필드를 더하는 정도라면 기존 버전에서 문서만 갱신한다.
진화 판단 기준
API 변경 호환성 구분
새 버전은 모든 변경의 기본값이 아니다. 기존 클라이언트가 그대로 동작하는지부터 확인해야 한다.
변경 유형별 선택
선택 파라미터 추가
기본 동작을 유지하고 Swagger에 사용 조건을 명확히 적는다.
필드 제거 또는 이름 변경
기존 앱이 깨질 수 있으므로 새 버전과 마이그레이션 안내가 필요하다.
구버전 종료
지원 기간, 공지 채널, 제거 날짜를 문서와 운영 절차에 함께 남긴다.