概览
下面是一些帮助您启动和运行 GraphQL API v4 的快速链接:
关于 GraphQL
GraphQL 数据查询语言为:
-
强类型化。架构可定义 API 的类型系统和所有对象关系。
-
内省。客户端可查询架构,了解关于架构的详细信息。
-
层次。GraphQL 调用的形式可反映它返回的 JSON 数据的形式。 嵌套字段可用于仅查询和接收您在单个往返向行程中指定的数据。
-
应用层。GraphQL 不是存储模型或数据库查询语言。 graph 是指架构中定义的图形结构,其中,节点定义对象,边缘定义对象之间的关系。 API 可以根据架构定义遍历和返回应用数据,与数据的存储方式无关。
GitHub 为什么使用 GraphQL
GitHub 选择将 GraphQL 用于 API v4,因为它可以为我们的集成商提供明显更高的灵活性。 准确定义所需数据—仅仅是您所需的数据—的能力是它超越 REST API v3 端点的强大优势。 GraphQL 可用于将多个 REST 请求替换为单个调用,以获取您指定的数据。
有关 GitHub 为什么移动到 GraphQL 的详细信息,请参阅原始公告博客文章。
关于 GraphQL 架构引用
边栏中的文档是从 GitHub GraphQL 架构 生成的。 所有调用均根据架构验证和执行。 使用这些文档查找您可以调用的数据:
您可以通过 Explorer 文档边栏访问同样的内容。 请注意,您可能需要依靠文档和架构验证才能成功调用 GraphQL API。
有关其他信息,如身份验证和速率限制详细信息,请查看指南。
请求支持
For questions, bug reports, and discussions about GitHub 应用程序, OAuth 应用程序, and API development, explore the GitHub API 开发和支持论坛. 该论坛由 GitHub 工作人员管理和维护,但不能保证发布到论坛的问题都会得到 GitHub 工作人员的回复。
对于以下问题,请考虑使用联系表直接联系 GitHub Support:
- 要保证得到 GitHub Enterprise Server 工作人员的回应
- 涉及敏感数据或私人问题的支持请求
- 功能请求
- 关于 GitHub Enterprise Server 产品的反馈