PR #2360 앱 강제 업데이트 대응 가이드
클라이언트 개발자가 앱 실행 시점의 업데이트 분기와 서버 응답 해석만 빠르게 확인할 수 있도록 정리한다.
한눈에 보기
| 상황 | 서버 응답 | 클라이언트 액션 |
|---|---|---|
| 최신 또는 지원 버전 사용 | updateRequired = false | 정상 진입 |
| 최소 지원 버전 미만이지만 아직 차단 전 | updateRequired = true, forceBlocked = false | 업데이트 권고 팝업 또는 배너 노출 |
| 차단 시점이 지난 구버전 사용 | updateRequired = true, forceBlocked = true | 서비스 진입 차단, 스토어 업데이트 강제 |
| 활성 정책 없음 | updateRequired = false, forceBlocked = false | 정상 진입 |
호출 API
GET /mobile/app-version/check
Query:
| 필드 | 예시 | 설명 |
|---|---|---|
platform | iOS | 플랫폼 |
currentVersion | 1.5.2 | 현재 앱 버전 |
응답 예시:
{
"updateRequired": true,
"forceBlocked": false,
"minimumVersion": "1.5.0",
"latestVersion": "1.8.0",
"deprecatedAt": "2026-03-20T00:00:00.000Z"
}
응답 필드 해석
| 필드 | 의미 | 클라이언트 사용 방법 |
|---|---|---|
updateRequired | 현재 버전이 최소 지원 버전보다 낮은지 여부 | 업데이트 안내 UI 노출 여부 판단 |
forceBlocked | 현재 시점에 앱 사용을 막아야 하는지 여부 | 진입 차단 여부 판단 |
minimumVersion | 서버가 허용하는 최소 버전 | 안내 문구에 활용 가능 |
latestVersion | 최신 권장 버전 | 스토어 이동 안내에 활용 가능 |
deprecatedAt | 강제 차단 시작 시각 | 안내 문구 또는 QA 검증용으로 사용 |