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