본문으로 건너뛰기
모바일 가이드

API 버전 관리 전략: 완전한 결정 안내서

API 버전 관리 전략을 선택하세요. URI, 헤더 및 쿼리 패턴, 마이그레이션 전략 및 테스트 최적화 방법을 비교하세요.

마틴 도나디유

마틴 도나디유

컨텐츠 마케터

API 버전 관리 전략: 완전한 결정 안내서

일반적으로 __CAPGO_KEEP_0__ 버전 관리 전략을 알게 되지 않습니다. API 버전 관리 전략 까지는 __CAPGO_KEEP_0__ 버전 관리 전략이 보이지 않습니다.

실질적인 질문은 버전을 사용할 것인가가 아니라, 어떻게 오래된 클라이언트를 살리고 API를 영원히 멈추지 않도록 유지할 것인가이다. API 문서로 간주되는 것과 실제 호환성 약속으로 간주되는 것 사이의 경계를 정의하는 유용한 프라이머가 왜 필요하다는 것 내용 목록

__CAPGO_KEEP_0__가 버전 관리 전략을 필요로 하는 이유

API가 버전 관리 전략을 필요로 하는 이유

나는 세 가지 각도에서 이 실패를 보았다. 스테이징에서 불만이 없었기 때문에 백엔드 팀이 응답 필드를 제거했다. 앱 스토어에 이미 출시된 모바일 릴리즈는 빠르게 업데이트할 수 없었다. 기업 고객들은 PROCUREMENT 주기보다 릴리즈 트레인보다 느린 속도로 업데이트를 요청했다.

그것이 버전 관리가 예방해야 하는 것이다. 그것은 __CAPGO_KEEP_0__ 소유자와 모든 계약에 의존하는 클라이언트 간의 호환성 약속이다. URL이 정돈된다는 것만 아니라, 팀이 변경할 수 있는 것과 안정해야 하는 것을 명확히 하기 위해 규칙을 명시하는 것이다. 만약 유용한 __CAPGO_KEEP_0__ 문서화에 대한 개요를 원한다면, 그 프레임워크가 도움이 될 것이다. 왜냐하면 버전 관리는 __CAPGO_KEEP_0__ 표면의 나머지 계약 규칙과 동일한 범위에 속하기 때문이다. 실용적인 규칙: 클라이언트가 일정에 따라 업데이트할 수 없다면, API에는 명시적인 호환성 정책이 필요하다. URL이 변경되지 않아도. 버전 관리는 API 표면의 나머지 계약 규칙과 동일한 범위에 속한다.버전 관리는 API 표면의 나머지 계약 규칙과 동일한 범위에 속한다.

버전 관리는 __CAPGO_KEEP_0__ 표면의 나머지 계약 규칙과 동일한 범위에 속한다. 버전 관리는 API 표면의 나머지 계약 규칙과 동일한 범위에 속한다.

선택은 매트릭스, slogannya 아니다. 팀 크기는 중요하다. 작은 그룹은 수동으로 변경을 조율할 수 있지만, 큰 조직은 수동 전달을 견딜 수 있는 규칙이 필요하다. 클라이언트 제어는 중요하다. 웹 클라이언트는 빠르게 리프레시할 수 있지만, 모바일 클라이언트는 그렇지 못하다. 릴리스 주기는 중요하다. 자주 릴리스하는 팀은 오류를 더 빨리 폐기할 수 있지만, 승인과 저장소 검토를 기다리는 팀은 그렇지 못하다.

내부 소비자만 제공하는 백엔드 팀은 종종 오랜 시간 동안 버전 관리를 가볍게 유지할 수 있다. 세 번째-party 통합자와 함께하는 공개 API는 훨씬 더 명확한 경계가 필요하다. 오프라인 동작이나 느린 채택을 하는 모바일 앱은 가장 엄격한 계획이 필요하다. 왜냐하면 한 번 잘못된 클라이언트 버전이 세상에 나면 사용자가 업데이트할 때까지 그것을 살아야 하기 때문이다.

실패 모드는 예측 가능하다. 침묵적인 브레이크는 명백한 하나지만, 앱 스토어 문제는 일반적으로 더 나쁘다. 왜냐하면 스토어는 이미 이전 버전을 사용 중인 사용자를 구원하기 위해 패치를 빨리 수용하지 않기 때문이다. 장기적인尾치는 엔터프라이즈 클라이언트가 승인에 의존하는 것보다 엔지니어링 선호도에 의존하지 않기 때문에 오래된 엔드포인트를 계속 사용하는 것이다.

좋은 전략은 브레이크가 발생하기 전에 질문을 해결한다. 어떤 변경이 새로운 메이저 버전을 요구하는가. 어떤 클라이언트가 먼저 경고를 받는가. 오래된 버전이 살아남는 기간은 얼마나 되는가. 이러한 결정은 모바일 앱에 더 중요하다. 왜냐하면 사용자는 웹 페이지와 같이 빠르게 리프레시하지 않기 때문이다. 또한 크로스 플랫폼 앱 소유자와 같은 팀은 도구와 함께 릴리스 계획을 구현할 수 있어야 한다. Capgo의 Capacitor과 Appflow 버전 차이 비교.

버전을 관리하지 않는다면, 정책을 선택하고 있지만, 그 정책을 모든 사람이 살아야 하는 사람들에게 숨기고 있기 때문에 보이지 않는 정책을 선택하고 있다.

버전 관리 패턴 4 가지 비교

4 가지 일반적인 패턴은 동일한 문제를 다른 장소에서 해결한다. URI 버전 관리는 경로에 버전을 넣고, 헤더 버전 관리는 요청 메타데이터에 버전을 이동시키고, 쿼리 매개 변수 버전 관리는 기본 경로를 안정화하고 매개 변수를 추가하고, 미디어 타입 버전 관리는 콘텐츠 협상 사용한다. 올바른 선택은 팀이 투명성, 캐시 동작, 또는 장기적인 URL 청결성을 가치로 여부에 따라 달라진다.

URI 버전 관리

/v1/users 로그, 브라우저 추적, 또는 지원 티켓에서 가장 쉽게 읽을 수 있는 패턴이다. 신입 개발자가 버전을 즉시 식별하고, 고객이 정확한 URL을 붙여넣도록 도와주는 데 도움이 되는 도움말 데스크 에이전트도 쉽게 버전을 식별할 수 있다. 이러한 투명성은 그 이유로 가장 일반적인 기본값으로 남아 있다.

버전 관리 패턴의 단점은 명확하다. 버전이 모든 경로에 유출되고, 경로가 버전 관리가 느슨한 경우에 버전이 오래 살아남게 된다.

헤더 버전 관리

다음과 같은 요청을 사용하면 URL이 깨끗하고, 여러 계약 버전이 동일한 리소스 경로를 공유할 수 있다. 동일한 엔드포인트가 여러 소비자에게 서비스를 제공해야 하는 경우 경로 구조를 지저분하게 하지 않도록 유용하다. 또한 이미 형식 협상과 함께 사용하는 API와도 잘 어울린다. Accept: application/vnd.example.v2+json __CAPGO_KEEP_0__’s comparison of __CAPGO_KEEP_1__ and Appflow versioning differences

운영상의 마찰은 단점입니다. 버전 관리는 디버깅 중에 더 어려울 수 있고, 캐시 또는 프록시를 구성할 때 응답을 혼합하지 않도록 주의해야 합니다. CDNs 또는 에지 레이어를 통해 라우팅하는 팀에게는 이 추가적인 discipline이 중요합니다.

쿼리 매개 변수 버전 관리

/users?version=2 파트너 API가 빠른 마이그레이션 경로가 필요할 때 쉽게 추가하고 쉽게 사용할 수 있습니다. 경로 자체가 안정적이지만 계약이 가볍고 선택자로 사용할 수 있는 경우 유용합니다. 브라우저와 대부분의 클라이언트 라이브러리들은 쿼리 문자열을 많은 절차 없이 이해합니다.

캐싱 복잡성의 단점은 중간 시스템이 쿼리 기반 변화를 잘못 처리할 수 있고, API 게이트웨이는 일반적인 로직을 사용하여 이를 존중해야 합니다. 따라서 처음에는 강력해 보이지만 실제로는 더 취약합니다.

미디어 타입 버전 관리

미디어 타입 버전 관리는 Accept 헤더를 사용하여 특정 표현을 요청하여 리소스 URL이 안정적이고 더 세분화된 콘텐츠 협상 지원을 제공합니다. 이는 성숙한 API가 리소스 식별성과 계약 형태를 분리하고 싶을 때 매력적입니다. 이 기술은 헤더 버전 관리의 근친족이지만 협상 스토리가 더 명확합니다.

비용은 수용의 마찰입니다. 더 많은 팀이 경로 또는 미디어 타입을 읽거나 디버깅하는 것을 편안하게 생각하지 않기 때문입니다.established한 후에는 깨끗하지만, API에 접근하는 모든 팀이 discipline을 유지해야 합니다.

패턴 可視性 캐싱 추천
URI 버전 관리 높음 직관적 작은 팀, 디버깅, 빠른 온보딩
헤더 버전 관리 URL에서 낮고 code에서 높음 주의 깊게 설정해야 함 공개 API, 안정적인 리소스 경로
쿼리 매개 변수 버전 관리 중간 매우 까다로움 파트너 API, 빠른 마이그레이션
API 버전 관리 전략 URL에서 낮고, 헤더에서 중간 협상에 대한 캐시가 필요하다 성숙한 API, 세세한 계약 제어

내부 메커니즘은 다르지만, 트레이드 오프 패턴은 안정적이다. URI 버전 관리는 단순성과 디버그 가능성에서 우수하다, 하지만 헤더 및 미디어 타입 버전 관리는 깨끗한 URL 및 더 세세한 협상에서 우수하다. 관련 제품 analogy에 대해, Capacitor 버전 관리 차이점 안내서 은 인접 릴리스 시스템이 명확성과 라우팅 복잡성을 균형을 이룰 때까지 어떻게 균형을 이룰 수 있는지 보여준다.

API에 Semantic Versioning을 적용한다

SemVer 레이블은 팀이 계약 위반으로 간주하는 것을 결정하는 데만 도움이 됩니다. MAJOR 파괴적인 변경을 다룹니다. MINOR 뒤로 호환되는 추가 기능을 다룹니다. PATCH 계약을 변경하지 않는 버그 수정을 다룹니다. 그 규칙은 유용합니다. 소비자는 미니어처 및 패치 업데이트를 흡수하는 데 더 적은 조정을 필요로 하며, 메이저 업데이트는 소비자에게 code 변경을 계획하도록 알려줍니다.

클라이언트가 깨지는 실제 것

응답 필드를 제거하는 것은 클라이언트가 읽는 경우 깨집니다. 속성을 이름을 바꾸는 것은 같은 이유로 깨집니다. 값의 의미를 변경하는 것도 깨집니다. JSON 형태가 동일한 경우에도.

선택적 필드를 추가하는 것은 추가적입니다. 새로운 엔드포인트를 추가하는 것도 추가적입니다. 설명에 있는 잘못된 글자를 고치는 것은 패치입니다. 왜냐하면 그것은 통신을 변경하지 않기 때문입니다. 그 것이 바로 SemVer가 API에만 사용되는 것이 아니라는 이유입니다.

실제로, 나는 소비자가 편집해야 하는 변경을 code으로 간주할 때까지 메이저로 간주합니다.

위의 경험적 연구는 버전 필드를 사용하는 API 중에서 의미적 버전 관리가 많은 릴리스를 차지한다고 밝혔습니다. 그만큼 의미적 버전 관리를 API에서 사용해야 한다는 것은 아니지만, 그것은 의미적 버전 관리가 공공 API 기록에서 일반적인 정신 모델임을 보여줍니다. 실제로, 나머지 field는 달력 레이블, 혼합된 규약, 또는 명시적인 규칙이 없는 경우가 많습니다.

__CAPGO_KEEP_0__ 계약 버전을, 단지 엔드포인트만 버전화하는 것보다 중요합니다.

대규모 버전이 일반적으로 마이그레이션 노트와 호환성 윈도우와 함께 배포되어야 합니다. 이는 비밀, 인증, 또는 요청 서명이 포함된 경우尤其 중요합니다. 버전 변경은 팀이 보호해야 하는 표면을 변경할 수 있기 때문입니다. Webtwizz API 키 보안 가이드 버전 업데이트가 클라이언트 인증 또는 자격 증명 회전 방법을 변경하는 경우 유용한 동반자입니다.

버전 번호는 팀이 이를 행동을 시그널로 사용할 때만 도움이 됩니다. __CAPGO_KEEP_0__ semantic versioning guide Capgo semantic versioning guide takes that operational view, which is the right instinct for API releases too. SemVer becomes a release rule, not a branding choice.

실용적인 규칙은 간단합니다. 뒤로 호환되는 변경 사항을 자유롭게 추가하십시오.만약 깨트리려면, 대규모 버전을 업데이트하고 클라이언트에게 마이그레이션 경로를 제공하십시오.

팀 크기

팀 크기

팀 크기 팀 크기, 클라이언트 제어, 그리고 릴리스 주기 의식보다 버전 선택을 더 많이 형성한다. 작은 스타트업이 주간 릴리스를 하는 것은 금융 플랫폼이 외부 통합자에게 업데이트를 하는 일정에 따라 업데이트를 하는 것과 같은 문제를 가지고 있지 않다.

버전 선택을 위한 팀이 크기, 제어, 릴리스 주기에 따라 올바른 API 패턴을 선택하는 데 도움을 주는 인포그래픽 플로우 차트.

작은 팀이 빠르게 배포하는 경우

두 명의 스타트업이 주간 릴리스를 하는 경우는 URI 버전링과 SemVer를 사용하는 것이 좋다. . 이의 이유는 순수성 때문이 아니라 압박하에 속도 때문이다. 로그는 읽을 수 있고, 라우팅은 명확하고, 새로운 직원에게 계약을 설명할 수 있는 팀은 긴 온보딩 의식이 필요하지 않다.URL의 버전 churn의 단점은 URL이 공개되면 버전을 계속 쌓고 청소하지 않도록 유혹하는 것이다. 작은 팀은 초기에 강력한 버전 폐기 정책을 가지고 있어야 하거나, '단순한' 패턴이 버전 스프롤로 변하지 않도록 해야 한다.

클라이언트 제어가 약한 대규모 공개 API v1 릴리스 주기

의식보다 버전 선택을 더 많이 형성한다. 작은 스타트업이 주간 릴리스를 하는 것은 금융 플랫폼이 외부 통합자에게 업데이트를 하는 일정에 따라 업데이트를 하는 것과 같은 문제를 가지고 있지 않다.

금융 기술 규제 또는 여러 파트너 통합을 가진 플랫폼은 헤더 버전화 또는 미디어 타입 버전화이 방법은 한 리소스 경로를 안정적으로 유지하면서 여러 계약을 뒤에 있는 것처럼 동작합니다. 여러 계약이 뒤에 있는 것처럼 동작하는 동안 한 리소스 경로를 안정적으로 유지하는 것이 중요합니다.

이것은 업데이트를 즉시 요청하거나 단일 전환 날짜를 협상할 수 없는 경우에 더 적합한 선택입니다.

운영적 규율의 비용이 있습니다. 캐시, 프록시, 지원 도구 모두 요청에서 사용한 버전을 이해해야 합니다. 이 부분에서 추가적인 플러밍이 가치가 있습니다. 클라이언트는 오래되고 조정하기 어려운 것이기 때문입니다.

대행사 및 기한에 따라 클라이언트 작업 대행사가 클라이언트의 앱을 배포하는 경우 일반적으로 URI 버전화

을 선호합니다. 이는 전달 중인 앱의 URL에서 버전을 쉽게 확인할 수 있기 때문입니다. 앱이 이미 운영 중인 경우 지원 질문이 더 쉽게 답변될 수 있습니다. 유지보수에 대한 명확성이 협상보다 중요할 때 이 방법이 실용적입니다.

이 방법의 단점은 예쁜 URL이 중요하지 않다는 것입니다. 예쁜 URL이 중요하지 않다면 예쁜 URL을 유지하기 위해 노력하는 것은 의미가 없습니다. 다른 사람의 지원 부담을 물려받을 때 예쁜 URL이 중요하지 않습니다.

그 규칙과 일치하는 결정 tree는 infographic에서 나옵니다. 작은 내부 팀은 경로 기반의 단순성 tolerate 할 수 있습니다. 파트너 API는 더 많은 유연성을 필요로합니다. 대규모 공개 API는 릴리스 주기와 클라이언트 다양성으로 인해 경로 기반 버전 관리가 너무 단순하기 때문에 헤더 기반의 제어를 사용하는 것이 일반적입니다.

모바일 및 크로스 플랫폼 앱의 버전 관리

모바일 클라이언트는 규칙을 바꾸기 때문에 밤중에 강제로 업데이트를 할 수 없습니다. 아이폰 사용자는 몇 달 동안 이전 버전을 사용할 수 있고, 사이드 로드 된 안드로이드 앱은 더 오래 살아남을 수 있습니다. 따라서 버전 관리는 더 이상 예술적인 문제가 아니라 이전 버전과 새로운 버전의 code 경로를 동시에 유지하는 문제가 됩니다.

스타트업이 Capacitor 앱을 배포하는 경우

스타트업이 CapacitorJS 앱을 배포하고 Capgo 라이브 업데이트를 사용하여 사용자 코호트에 자바스크립트 수정을 푸시합니다. 앱은 배포 업데이트 후 새로운 API field가 필요하지만, 모든 기기는 동일한 날짜에 새로운 code를 받을 수 없습니다. 가장 안전한 방법은 앱이 서버의 새로운 및 이전 동작을 유연하게 감지하면서 API가 이전 계약을 배포 중인 동안 유지하는 것입니다.

이것은 중요합니다. 라이브 업데이트만은 백엔드 계약을 변경하지 않습니다. 단지 code와 배포 간의 지연 시간을 줄 뿐입니다. Capgo 버전 관리 워크플로 가이드 이것은 배포 롤아웃을 제어된 호환성 문제로 대신 다루는 대신 단순히 모든 것을 교체하는 이벤트로 다루는 대신 잘 맞습니다.

규제된 기업에 장기적으로 사용되는 field 장비가 있는 경우

건강 관리 팀이 오래된 태블릿을 지원하는 필드 직원에게는 다른 제약 조건이 있습니다. 앱은 새로운 빌드가 출시된 후에도 오래 사용할 수 있으며, API은 짧은 업그레이드 기간을 가정할 수 없습니다. 안전한 패턴은 v1을 유지하고, 클라이언트 버전별로 라우팅하고, 사용량을 측정하여 팀이 해산일이 현실적인지 알 수 있도록 합니다.

문서도 엔지니어 팀과 사용자가 현장에서 문제를 진단하는 데 사용할 수 있어야 합니다. API 엔드포인트에 대한 실용적인 팀이 이름, 라우팅, 클라이언트 예상치를 표준화할 수 있도록 도와줍니다.

같은 버전 관리 전략은 두 가지 경우 모두 다르게 작동합니다. 클라이언트가 다르게 행동하기 때문입니다. 한 경우 업데이트 채널은 제어하실 수 있습니다. 다른 경우는 아닙니다. 그 때문입니다. 모바일 팀은 웹 팀이 기대하는 것보다 더 엄격한 계약 관점이 필요합니다.

Deprecation, Migration, and Sunset Without Breaking Clients

버전 관리의 가장 어려운 부분은 새로운 버전을 만들기보다 오래된 버전을 끄는 것입니다. 사용자들이 여전히 사용하는 것을 놀라지 않도록 합니다. 올바르게 처리하는 팀은 해산을 운영 프로세스로 다루고, 일회성 발표로 다루지 않습니다.

해산을 표시하세요

응답에 해산 신호를 사용하고, 실제 해산 날짜를 뒷받침하세요. 유용한 헤더는 해산, 해산일그리고 링크 이동 가이드로 이동하세요. 그곳에서 클라이언트에게 현재는 이전 버전이 살아남고 있지만, 시간이 흐르면 종료될 것이라고 알려줍니다.

해당 API의 종료 날짜는 사용량에 따라 결정되어야 합니다. 대중 API는 기업 제품보다 짧은 기간 동안 지원해야 합니다. 이는 소비자 혼합물이 더 불안정하기 때문입니다. 대형 고객에게는 일반적으로 더 긴 병렬 실행이 안전합니다. 이는 마이그레이션에 더 많은 사람과 더 많은 테스트가 관여하기 때문입니다.

두 버전을 병렬로 실행하세요

병렬 지원은 비용이 많이 들지만, 지원 인циデнт보다 저렴합니다. 2025년 API 보고서에 대한 2026년 엔지니어링 분석에 따르면 60% API 버전을 관리하는 팀은 많지만, 26% 세미나틱 버전 관리를 사용하는 팀은 적고, 17% 계약 테스트만 실행하는 팀이 있습니다.분석API 버전 관리를 위한 규칙이 없이는 팀이 버전의 해제가 안전한지 알 수 없습니다.

마이그레이션을 담당하는 사람을 지정하세요. 많은 사람들이 도움을 주더라도. 그 사람은 사용량을 추적하고, 클라이언트와의 통신을 책임지고, 종료 시각이 필요한지 결정합니다. 그 역할이 없으면 이전 버전이 남아있게 됩니다. 왜냐하면 nobody가 최종 버전을 책임지지 않기 때문입니다.

The API 버전 마이그레이션 가이드라인 __CAPGO_KEEP_0__ 버전 마이그레이션 가이드라인은 mainstream 조언의 실제 약점을 지적합니다. 대부분의 출처는 “여러 버전을 지원하라”고 “이른 발표”를 권장하지만, 소유권이 누구에게 있는지 또는 해산 정책이 강제되는지 설명하는 출처는 적습니다. 이 약점은 장단점이 다른 클라이언트가 갇히는 곳입니다.

테스트 및 모니터링: 깨진 변경을 일찍 잡아내는 방법

API 계약이 CI에서 변경될 수 있는 경우 버전 번호로만 구현되지 않습니다. 팀은 클라이언트가 깨진 변경을 감지하기 전에 깨짐을 잡아내는 루프가 필요합니다.

계약을 pipe라인에 넣어라

계약 테스트는 CI에서 수행되어야 하며, 구현이 더 이상 계약에 맞지 않거나 예상한 상호 작용과 일치하지 않으면 실패해야 합니다. Pact, Spectral, Postman 계약 테스트와 같은 도구는 계약을 실행 가능한 것으로 만듭니다. 디자인 pipe라인에서 스키마 비교는 두 번째 경계를 만듭니다. 이는 merge 전에 명백한 깨짐을 막습니다.

제품 모니터링은 세 번째 경계입니다. 버전, 엔드포인트, 클라이언트에 따라 사용량을 추적하여 v1에 아직 남아있는 클라이언트가 있는지, 오류율이 변하는지 알 수 있습니다. 이는 해산이 안전한지 결정하는 유일한 신뢰할 수 있는 방법입니다.

유용한 패턴: 디자인 시점 스키마 검사, CI 계약 테스트, 제품 버전 메트릭스, 그리고 릴리즈 후 오류 프로파일이 변경되면 롤백

그것 자동화된 테스트 가이드 이것은 API 롤아웃 안전성에 관련이 있기 때문에 모바일 릴리스 안전성과 같은 규칙을 사용합니다. API가 잘못되면 빠른 롤백 경로와 단계적 노출, 관찰 가능한 동작이 필요합니다. 이것은 JS 번들이나 계약 변경을 배포하는 경우 모두 적용됩니다.

API의 깨지지 않는 변경을 예방하기 위한 테스트 및 모니터링의 세 단계 사이클을 나타내는 다이어그램입니다.

이러한 구성 요소가 함께 작동할 때, 버전 관리는 반응적이지 않습니다. API 팀은 문제를 일찍 발견하고 지원 팀은 증거를 가지고 있으며 고객은 더 적은 놀랄만한 결과를 경험합니다.

API 버전 관리 체크리스트 및 다음 단계

이것을 실제로 만들기 위해 가장 빠른 방법은 정책을 쓰고 팀에게 이를 사용하도록 강요하는 것입니다. 버전 관리 전략은 릴리스 프로세스의 나머지 부분과 같은 장소에 존재해야 유용합니다.

API 버전 관리 전략의 6단계 체크리스트, 아이콘, 설명적 작업, 완료된 상태 체크마크를 특징으로 합니다.

체크리스트 복사

  • 하나의 패턴을 선택하고 스타일 가이드에 기록하세요. 팀이 URI, 헤더, 쿼리, 미디어 타입 버전 관리를 선택한다면, 미래 릴리스가 임의로 행동하지 않도록 이유를 문서화하세요.
  • 파괴적인 변경을 한 문장으로 정의하세요. 제거, 이름 변경, 클라이언트 편집을 강요하는 동작 변경을 포함하세요.
  • CI에 계약 테스트를 추가하세요. implementation과 contract가 다르면 pipeline이 실패하도록 하세요.
  • 해당 API가 deprecated되거나 sunset되었습니다. 클라이언트는 blog 포스트만으로는 충분하지 않습니다. machine-readable warning signals이 필요합니다.
  • 버전별 사용량을 추적하세요. old endpoint에 접속하는 사용자를 확인할 수 없다면, 그 endpoint를 안전하게 폐쇄할 수 없습니다.
  • 다음 마이그레이션에 대한 책임자를 assign하세요. 책임자가 없다면,
  • forced-deprecation tabletop exercise를 진행하세요. v1 shutdown을 임시로 시뮬레이션하고, 어떤 클라이언트, alert, dashboard가 먼저 실패하는지 확인하세요.

release cohorts를 사용하는 모바일 배포에 이미 release management process guide를 사용하고 있다면, release management process guide API 마이그레이션에도 rollout control을 유지하는 방법을 보여줍니다.

버전 관리는 변화가 불가능하도록 만드는 것이 아니라, 변화가 살아남을 수 있도록 만드는 것입니다. 정책을 정의하고, 테스트하고, 모니터링하고, 클라이언트에게 앞으로의 경로를 제공하여 이전 경로가 닫히기 전에.


Capgo은 모바일 팀에게 클라이언트 측에서 API 버전 관리 전략이 백엔드에서 제공하는 같은 종류의 릴리스 제어를 제공합니다. Capacitor 또는 Electron 앱을 배포하는 경우를 방문하세요. Capgo 안정적인 __CAPGO_KEEP_1__ 버전 관리 전략이 백엔드에서 제공하는 것과 같은 종류의 릴리스 제어를 클라이언트 측에서 제공하는 __CAPGO_KEEP_0__은 모바일 팀에게.

Capacitor 앱에 대한 실시간 업데이트

웹-layer 버그가 활성화된 상태에서 앱 스토어 승인까지 며칠 기다리지 않고 Capgo를 통해 수정을 배포하세요. 사용자는 배경에서 업데이트를 받으면서 네이티브 변경 사항은 일반적인 리뷰 경로를 유지합니다.

인간 지원을 위한 전문적인 서비스를 받으세요.

시작하기

최신 블로그

Capgo은 전문적인 모바일 앱을 만들기 위해 필요한 최고의洞察력을 제공합니다.