변경 로그

공개 v1 계약의 모든 변경 사항은 배포 전에 호환성 정책에 따라 검토됩니다. 추가적인 변경 - 새 엔드포인트, 새 선택적 요청 필드, 새 응답 필드, 새 웹훅 이벤트 - 은 v1 내에서 지속적으로 배포되며 마이그레이션을 요구하지 않습니다.

예상할 수 있는 변경

• 새로운 엔드포인트와 필드는 언제든지 추가될 수 있습니다. 인식할 수 없는 응답 필드는 오류로 처리하지 말고 허용하세요.
• 기존 v1 작업과 문서화된 성공 상태 코드는 제거되지 않으며, 기존 쓰기 작업에 새로운 필수 매개변수, 요청 본문 또는 JSON 속성이 추가되지 않습니다.
• SDK 작업 매핑과 선별된 MCP 도구는 CI에서 현재 계약을 기준으로 검증되므로 경로와 필수 범위가 조용히 달라질 수 없습니다.

---

변경 사항 추적

• API 레퍼런스는 항상 현재 배포된 계약을 반영합니다. 업그레이드할 때 사용 중인 연동과 비교하세요.
• 호환성이 깨지는 변경은 마이그레이션 및 버전 관리 정책의 적용을 받으며, 이 정책이 요구되는 검토·사전 고지·마이그레이션 경로를 정의합니다.