关于 GraphQL API

GitHub GraphQL API 具有灵活性，而且能够准确定义您要获取的数据。

下面是一些帮助您启动和运行 GraphQL API v4 的快速链接：

GraphQL 数据查询语言为：

规范。此规范可确定 API 服务器上架构的有效性。架构可确定客户端调用的有效性。
强类型化。架构可定义 API 的类型系统和所有对象关系。
内省。客户端可查询架构，了解关于架构的详细信息。
层次。GraphQL 调用的形式可反映它返回的 JSON 数据的形式。嵌套字段可用于仅查询和接收您在单个往返向行程中指定的数据。
应用层。GraphQL 不是存储模型或数据库查询语言。 graph 是指架构中定义的图形结构，其中，节点定义对象，边缘定义对象之间的关系。 API 可以根据架构定义遍历和返回应用数据，与数据的存储方式无关。

GitHub 选择将 GraphQL 用于 API v4，因为它可以为我们的集成商提供明显更高的灵活性。准确定义所需数据—仅仅是您所需的数据—的能力是它超越 REST API v3 端点的强大优势。 GraphQL 可用于将多个 REST 请求替换为单个调用，以获取您指定的数据。

有关 GitHub 为什么移动到 GraphQL 的详细信息，请参阅原始公告博客文章。

边栏中的文档是从 GitHub GraphQL 架构生成的。所有调用均根据架构验证和执行。使用这些文档查找您可以调用的数据：

您可以通过 Explorer 文档边栏访问同样的内容。请注意，您可能需要依靠文档和架构验证才能成功调用 GraphQL API。

有关其他信息，如身份验证和速率限制详细信息，请查看指南。

有关 GitHub 应用程序、OAuth 应用程序和 API 开发的问题、漏洞报告和讨论，请访问 GitHub API 开发和支持论坛。该论坛由 GitHub Enterprise 工作人员管理和维护，但不能保证发布到论坛的问题都会得到 GitHub Enterprise 工作人员的回复。

对于以下问题，请考虑使用联系表直接联系 GitHub Support：