{"meta":{"title":"주요 변경사항","intro":"각 REST API 버전에서 도입된 주요 변경사항에 대해 알아봅니다.","product":"REST API","breadcrumbs":[{"href":"/ko/enterprise-server@3.17/rest","title":"REST API"},{"href":"/ko/enterprise-server@3.17/rest/about-the-rest-api","title":"REST API 정보"},{"href":"/ko/enterprise-server@3.17/rest/about-the-rest-api/breaking-changes","title":"주요 변경사항"}],"documentType":"article"},"body":"# 주요 변경사항\n\n각 REST API 버전에서 도입된 주요 변경사항에 대해 알아봅니다.\n\n## REST API의 비호환적인 변경 사항에 대한 정보\n\nGitHub REST API의 버전이 지정됩니다. API 버전의 이름은 API 버전이 릴리스된 날짜를 기반으로 합니다. 예를 들어 API 버전 `2026-03-10`은 Tue, 10 Mar 2026에 릴리스되었습니다.\n\n파괴적인 변경은 통합을 손상시킬 수 있는 변경입니다. 호환성에 영향을 미치는 변경사항은 새 API 버전에서 릴리스됩니다. 중대한 변경 사항을 릴리스하기 전에 사전 통지를 드리겠습니다. 변경 사항에는 중요한 변화가 포함됩니다.\n\n* 전체 작업 제거하기\n* 매개 변수 이름 바꾸기 또는 제거하기\n* 응답 필드 제거하기 또는 이름 바꾸기\n* 새 필수 매개 변수 추가하기\n* 이전에 선택적이었던 매개 변수를 필수로 만들기\n* 매개 변수 또는 응답 필드의 형식 변경하기\n* 열거형 값 제거하기\n* 기존 매개 변수에 새 유효성 검사 규칙 추가하기\n* 인증 또는 권한 부여 요구 사항 변경하기\n\n모든 추가(호환 가능한) 변경 사항은 지원되는 모든 API 버전에서 사용할 수 있습니다. 추가 변경 내용은 통합을 중단해서는 안 되는 변경 내용입니다. 추가 변경 내용은 다음과 같습니다.\n\n* 작업 추가하기\n* 선택적 매개 변수 추가하기\n* 선택적 요청 헤더 추가하기\n* 응답 필드 추가하기\n* 응답 헤더 추가하기\n* 열거형 값 추가하기\n\n새 REST API 버전이 릴리스되면 새 API 버전이 릴리스된 후 최소 24개월 동안만 이전 API 버전이 지원됩니다.\n\nAPI 버전에 대한 자세한 내용은 [API 버전](/ko/enterprise-server@3.17/rest/about-the-rest-api/api-versions)을(를) 참조하세요.\n\n## 새 API 버전으로 업그레이드\n\n새 REST API 버전으로 업그레이드하기 전에 새 API 버전에 해당하는 이 페이지의 섹션을 확인하고 포함된 호환성이 손상되는 변경 내용을 이해하고 해당 API 버전으로 업그레이드하는 방법에 대해 자세히 알아봅니다.\n\n`X-GitHub-Api-Version` 헤더에서 새 API 버전을 지정하도록 통합을 업데이트할 때, 통합이 새 API 버전과 원활하게 작동하기 위해 필요한 변경 사항을 적용해야 합니다.\n\n통합이 업데이트되면 통합을 테스트하여 새 API 버전에서 작동하는지 확인합니다.\n\n"}