{"meta":{"title":"重大更改","intro":"了解每个 REST API 版本中引入的中断性变更。","product":"REST API","breadcrumbs":[{"href":"/zh/enterprise-server@3.19/rest","title":"REST API"},{"href":"/zh/enterprise-server@3.19/rest/about-the-rest-api","title":"REST API 简介"},{"href":"/zh/enterprise-server@3.19/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个月。\n\n有关 API 版本的详细信息，请参阅 [API 版本](/zh/enterprise-server@3.19/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<!-- markdownlint-disable liquid-quoted-conditional-arg search-replace GHD046 -->"}