REST API 版本 2026-03-10 已可用
Source: GitHub Changelog
之前,我们引入了基于日历的版本管理,为我们的 REST API 提供了一条演进路径,同时为集成方提供充足的时间和明确的升级指引。
现在,我们发布了日历版本 2026-03-10,这是 GitHub REST API 的最新版本。这是首个包含破坏性更改的日历版本。
本次发布的内容
版本 2026-03-10 为 REST API 引入了一系列破坏性更改。您可以在我们的破坏性更改文档中找到完整的更改列表以及升级指引。
提醒一下,非破坏性更改(例如新端点、可选参数、额外的响应字段)仍将在所有受支持的 API 版本中保持可用。
对现有集成的影响
版本 2022-11-28 将在今天起至少再支持 24 个月,未在请求中包含 X-GitHub-Api-Version 头部的请求仍将默认使用 2022-11-28。
当您准备好升级时,过程非常简单。先阅读新版本文档并根据破坏性更改对您的集成进行必要的修改,然后将 X-GitHub-Api-Version 头部更新为 2026-03-10,并验证您的集成在新 API 版本下能够如预期工作。
在我们的API 文档中使用版本选择器即可查看所有可用版本的文档。
接下来
我们将继续通过 GitHub 更新日志发布未来的 API 版本信息。
我们希望集成方采用 2026-03-10,以利用最新的增强功能和特性。虽然没有必须立即升级的压力,但迁移到新版本将帮助确保您的集成保持兼容,并从我们持续发布的新版本中受益。