버전 관리

현재 API 버전은 v1 이며 URL 경로(/v1/...)에 반영됩니다.

호환성을 유지하는 변경

다음 변경은 호환성을 깨지 않으므로 버전 변경 없이 언제든 추가될 수 있습니다.

• 새 엔드포인트 추가
• 새 선택적 요청 파라미터 추가
• 응답 객체에 새 필드 추가
• 새 이벤트 타입 추가
• 새 enum 값 추가 (클라이언트는 모르는 enum 값을 에러가 아닌 “알 수 없음”으로 처리해야 함)

호환성 깨짐 변경

호환성 깨짐 변경(필드 제거, 타입 변경, 이름 변경)은 새 버전(/v2, /v3, …) 하에 도입됩니다. 후속 버전 발표 후 최소 12개월 동안 이전 버전을 지원합니다.

발표 알림은 변경 이력을 구독하세요.