모바일 환경을 고려한 API 설계 경험이 있다면, 어떤 점에 주의했는지 설명해 주세요.

모바일 API를 개발하면서 버전 관리가 왜 중요한지를 직접 겪었습니다. API 응답 구조를 변경했을 때 이미 배포된 이전 버전 앱이 업데이트되지 않은 사용자 환경에서 오류가 나는 상황이 생겼습니다.

웹 앱은 배포하면 모든 사용자가 즉시 새 버전을 받지만, 모바일 앱은 사용자가 직접 업데이트해야 합니다. 이 차이를 처음 경험하고 나서 API를 변경할 때 기존 클라이언트가 정상 동작하는지를 명시적으로 확인하는 단계를 추가했습니다.

신규 필드를 추가하는 것은 하위 호환성이 유지되지만, 기존 필드를 제거하거나 타입을 바꾸는 것은 이전 클라이언트를 깨뜨릴 수 있습니다. 이후 API 변경 시 영향받는 클라이언트 버전 범위를 먼저 파악하고, 제거가 필요한 경우 deprecated 처리 후 일정 기간이 지난 뒤 제거하는 방식으로 접근했습니다. 모바일 API는 변경 비용이 웹보다 크다는 것이 이 경험에서 남은 결입니다.