关于 REST API 中的中断性变更
GitHub Enterprise Server REST API 已进行版本控制。 API 版本名称基于 API 版本的发布日期。 例如，API 版本 2022-11-28 在 Mon, 28 Nov 2022 上发布。
任何中断性变更都将在新 API 版本中发布。 中断性变更是可能会中断集成的变更。 中断性变更包括：
- 删除整个操作
- 删除或重命名参数
- 删除或重命名响应字段
- 添加新的必需参数
- 使以前的可选参数成为必需参数
- 更改参数或响应字段的类型
- 删除枚举值
- 向现有参数添加新的验证规则
- 更改身份验证或授权要求
所有支持的 API 版本都将提供任何附加（非中断性）更改。 附加更改是不应中断集成的更改。 附加更改包括：
- 添加操作
- 添加可选参数
- 添加可选请求标头
- 添加响应字段
- 添加响应头
- 添加枚举值
当发布新 REST API 版本时，在发布新 API 版本后，以前的 API 版本将至少支持 24 个月。
有关 API 版本的详细信息，请参阅 API 版本。
升级到新的 API 版本
在升级到新 REST API 版本之前，应阅读本页上对应于新 API 版本的部分，以了解包含哪些中断性变更，并详细了解如何升级到该 API 版本。
更新集成以在 X-GitHub-Api-Version 标头中指定新的 API 版本时，还需要对集成进行任何所需的更改，以便与新 API 版本一起工作。
更新集成后，测试集成以验证它是否适用于新 API 版本。
2022-11-28 的中断性变更
版本 2022-11-28 是引入基于日期的版本控制后 GitHub Enterprise Server REST API 的第一个版本。 此版本不包含任何中断性变更。