현재 버전
URL의 버전
버전 번호는 endpoint 경로에 나타납니다:Breaking vs. non-breaking 변경
Breaking 변경(코드 업데이트 필요)
이러한 변경은 주요 버전 업그레이드에서만 발생합니다:- Endpoint 제거
- 응답 field 제거
- 쿼리 파라미터 제거
- 새로운 필수 파라미터 추가
- field의 데이터 유형 변경
- field 또는 리소스 이름 변경
- 응답 코드나 오류 유형 변경
- 인증 scope 수정
Non-breaking 변경(추가)
버전 변경 없이 언제든지 발생할 수 있습니다:- 새 endpoint 추가
- 새 선택적 파라미터 추가
- 새 응답 field 추가
- 새 OAuth scope 추가
- 오류 메시지 텍스트 변경
- 프라이버시/보안 이유로 field null 처리
릴리스 일정
지원 중단 정책
새로운 주요 버전을 릴리스할 때:- 지원 중단: 이전 버전이 지원 중단됨으로 표시됨
- 지원 기간: 지원 중단된 버전은 정의된 기간 동안 계속 작동
- 은퇴: 지원 중단된 버전이 제거됨
정의
정보 유지
변경 사항에 대한 알림 받기:
Changelog
모든 플랫폼 변경 사항 및 업데이트.
포럼 공지
Breaking 변경 공지.
@XDevelopers
플랫폼 뉴스 및 업데이트.
뉴스레터
월간 다이제스트.
마이그레이션 리소스
새 버전이 릴리스되면 다음을 제공합니다:- 마이그레이션 가이드: 단계별 업그레이드 지침
- Endpoint 매핑: v1을 v2 대응으로
- 데이터 형식 변경: 객체 모델 차이
마이그레이션 개요
현재 마이그레이션 가이드.
Endpoint 맵
v1을 v2 endpoint 매핑.
모범 사례
v2 사용
최신 버전에서 새 프로젝트를 시작하세요.
공지 모니터링
changelog 및 포럼 업데이트를 구독하세요.
변경 사항 테스트
프로덕션 업데이트 전에 개발 환경에서 테스트하세요.
마이그레이션 계획
지원 중단까지 기다리지 말고 업그레이드하세요.