关于 OpenAPI 描述
OpenAPI 是用于描述 REST API 的� �准规范。 OpenAPI 描述允许人类和计算机� 需首先阅读文档或了解实现实现即可发现 API 的功能。 GitHub 已经以 OpenAPI 3.0 � �准文档的形式公开其 REST API。
获取 GitHub OpenAPI 描述
可以在开放源代� � REST API OpenAPI 说明存储库中找到说明。
我们以两种� �式提供描述。 捆绑版本适用于大多数情况，� 为它包括可重用且可读的 OpenAPI 组件。 如果您的工具不支持对组件的内联引用，我们还提供完全取消引用的版本。
使用 GitHub OpenAPI 描述
OpenAPI 描述有很多用途。 例如，可以：
- 生成您自己的 API 客户端。
- 验证并测试 GitHub REST API 集成。
- 使用第三方工具（如 Insomnia 或 Postman）探索 GitHub Enterprise Server REST API 并与之交互。
例如，GitHub 使用 REST OpenAPI 说明来生成 GitHub Enterprise Server REST API 参考文档。