현재 버전
| Version | Status | Description |
|---|---|---|
| v2 | 현재 | 최신 엔드포인트, 유연한 요금제, 모든 신규 기능 제공 |
| v1.1 | 레거시 | 제한적인 지원, 최소한의 업데이트 |
| Enterprise | 사용 가능 | 전용 지원이 포함된 대량 액세스 |
URL에서의 버전
호환성을 깨는 변경 vs. 호환성을 깨지 않는 변경
호환성을 깨는(Breaking) 변경 사항 (코드 업데이트 필요)
- 엔드포인트 제거
- 응답 필드 제거
- 쿼리 파라미터 제거
- 새로운 필수 파라미터 추가
- 필드의 데이터 type 변경
- 필드 또는 리소스 이름 변경
- 응답 코드 또는 오류 type 변경
- 인가 범위 수정
하위 호환성을 깨지 않는(추가적인) 변경
- 새로운 endpoint 추가
- 새로운 선택적 파라미터 추가
- 새로운 응답 필드 추가
- 새로운 OAuth scope 추가
- 오류 메시지 텍스트 변경
- 프라이버시/보안상의 이유로 필드를 null로 설정
릴리스 일정
| 유형 | 빈도 | 공지 |
|---|---|---|
| 메이저 버전 | 최대 연 1회 | 마이그레이션 가이드 제공 |
| 하위 호환성을 유지하는 변경 | 수시로 | 변경 로그 업데이트 |
| 보안 패치 | 필요 시 | 현재 버전에 적용될 수 있음 |
사용 중단 정책
- 사용 중단(Deprecation): 이전 버전을 사용 중단 대상으로 지정합니다.
- 지원 기간: 사용 중단된 버전은 정해진 기간 동안 계속 지원됩니다.
- 폐기(Retirement): 사용 중단된 버전이 제거됩니다.
정의
| 상태 | 의미 |
|---|---|
| Active | 새 기능과 수정이 계속 제공되는, 완전히 지원되는 상태 |
| Deprecated | 새 기능은 제공되지 않고, 심각한 버그만 수정되며, 사용이 권장되지 않는 상태 |
| Retired | 더 이상 사용할 수 없는 상태 |
최신 정보 받아보기
변경 내역
플랫폼의 모든 변경 사항과 업데이트
포럼 공지사항
주요 변경 사항 공지
@XDevelopers
플랫폼 소식과 업데이트
뉴스레터
월간 요약
마이그레이션 리소스
- 마이그레이션 가이드: 단계별 업그레이드 안내
- 엔드포인트 매핑: v1에서 v2에 해당하는 항목
- 데이터 형식 변경 사항: 오브젝트 모델 차이점
마이그레이션 개요
최신 마이그레이션 안내입니다.
엔드포인트 맵
v1에서 v2로의 엔드포인트 매핑입니다.
모범 사례
v2 사용
새 프로젝트는 최신 버전에서 시작하세요.
공지사항 모니터링
변경 로그와 포럼 업데이트를 구독하세요.
변경 사항 테스트
프로덕션에 반영하기 전에 개발 환경에서 테스트하세요.
마이그레이션 계획
지원 종료 시점까지 업그레이드를 미루지 마세요.