Apollo 개발자 API의 지원 정책 v1.0

Apollo 개발자 API와 CLI의 지원 범위는 표준 지원 정책과 제한 지원 정책으로 구분합니다. 별도의 제한 지원 표지가 없는 기능에는 표준 지원 정책이 적용됩니다. 지원 분류는 관련 명령이나 API 그룹 단위로 적용될 수도 있습니다.

표준 지원

표준 지원 기능은 외부 개발자가 연동을 구축하는 데 사용할 수 있으며, 문제에 대한 지원을 제공합니다. 기능 추가와 수정은 기존 사용을 깨뜨리지 않는 방향으로 이루어집니다.

표준 지원 기능이라도 이후 사용 중단 예고 상태인 Deprecated로 바뀔 수 있습니다. 분류가 바뀌면 그 시점부터 해당 제한 지원 정책을 따릅니다.

Apollo 개발자 API에서 Deprecated는 삭제 전의 사용 중단 예고 상태입니다. 기능 제거는 예고를 발표한 시점으로부터 최소 6개월 이후에 이루어집니다. 이 기간이 지난 기능은 실제로 제거할 수 있으며, 제거한 사실도 발표합니다.

API에서 제거되기 전까지는 지원을 제공합니다. 예고 기간이 지난 뒤에는 내려받아 둔 CLI나 캐시된 CLI, 제거된 API를 호출하는 스크립트가 계속 동작한다고 기대하면 안 됩니다. 일시적으로 호출이 성공하더라도 그 동작에 장기적으로 의존하지 않습니다.

실험 단계(Experimental)의 명령이나 API는 언제든 변경될 수 있습니다. 호환성을 깨뜨리는 변경이나 대체 기능 없는 삭제도 가능하며, 문제에 대한 지원 범위도 더 제한적입니다.

이 기능은 변경이나 중단을 받아들일 수 있는 경우에 사용합니다. 오랫동안 Experimental 상태였다는 사실이 안정성이 높거나 곧 표준 지원으로 전환된다는 의미는 아닙니다.

지원 분류의 변경은 발표로 알립니다. 표준 및 제한 지원 정책 자체에도 버전이 있으며, 그 정책의 호환성을 깨뜨리는 변경은 최소 6개월 전에 알립니다.

정책 변경의 사전 통보 기간과 개별 Experimental 기능의 변경 가능성을 구분해야 합니다. Experimental 기능 자체에는 표준 지원 기능과 같은 호환성 유지 조건이 적용되지 않습니다.