kikajack的博客

参考资料 GitHub 官方的资源限制相关（节点限制和速率限制）的文档1. 资源限制资源限制，需要在服务端实现。1.1 节点限制每次调用必须加节点数的限制，否则当数据量过大时会出问题。1.1.1 GitHub 的 GraphQL 接口调用规则：客户必须为每个 connection 提供 first 或 last 参数。first 或 last 参数的取值范围

客户使用 GraphQL 查询语言向 GraphQL 服务发出请求。我们将这些请求源称为文档。一个文档可能包含 operation 操作（query 查询和 mutation 变更都是操作）以及 fragment（片段）。1. Source Text 源文本GraphQL 支持的 Unicode 字符序列范围：/ [\ u0009 \ u000A \ u000D \ u0020- \ uF

官方参考文档GraphQL服务器收到一个请求时，它必须返回一个格式正确的响应。服务器的响应描述了操作的结果或遇到的错误。1. Serialization Format 序列格式1.1 概述GraphQL 不需要特定的序列格式。但是，客户端应该使用支持 GraphQL 响应中主要原语的序列化格式。 序列化格式必须支持以下四个类型的表示：MapListStringNu

1. 概述GraphQL 请求（查询，变更或订阅）在验证通过后，GraphQL 服务器会执行这个请求，并返回与请求的结构相对应的结果，通常是 JSON 格式。GraphQL 服务端处理请求时依赖类型系统。请求由几条信息组成：要使用的模式，必须是 GraphQL 服务端有效的模式。包含 GraphQL 操作和片段的文档（对于变更 mutation 和订阅 subscription，操

官方文档1. 概述GraphQL 不只验证请求在语法上是否正确，还验证在当前服务器的 GraphQL 模式上下文中是否正确。预判查询是否有效，从而可以让服务器和客户端在无效查询创建时就有效地通知开发者，而不用等运行时才知道。类型系统演变GraphQL 类型系统模式随着时间的推移而增加新的类型和新的字段，以前有效的请求有可能在以后变得无效。任何可能导致先前有效的请求变为无效的更改

官方文档1. 概述通过内省系统（Introspection System，也叫自检系统），我们可以知道服务端支持哪些查询，有哪些字段及字段类型等信息。 __Schema, __Type, __TypeKind, __Field, __InputValue, __EnumValue, __Directive 这些用两个下划线开头的类型是内省系统的一部分。// 查询 GitHub 中的

参考中文文档 参考博客资料1. 概念和示例GraphQL 服务端的库和应用可以用各种语言实现，所以这里的示例脱离语言。 GraphQL 服务端的应用代码的基本实现流程（需要提前安装好 GraphQL 库，各种语言的库参考这里）：定义用户自定义类型。类型的每个字段都必须是已定义的，且最终都是 GraphQL 中定义的类型。定义根类型。每种根类型中包含了准备暴露给服务调用方的用

完整的教程 完整标准查看这里 完整标准的中文版 淘宝前端团队的 GraphQL 入门教程 GitHub 的基于 GraphQL 的 API 接口示例 各种语言版本（Java，PHP，Node 等）的 GraphQL 服务端库1. GraphQL 概述GraphQL 是完整的 API 标准REST 只是一种 API 的风格，而 GraphQL 则是完整的 API 标准。

登录 GitHub 后，可以在这个地址在线验证。 参考资料 1. Fields（字段）// 请求{ viewer { id email repositories { totalCount } }}// 返回{ "data": { "viewer": { "id": "MDQ6VXNlcjE4NTM

REST 和 GraphQL 的对比 APIJSON 和 GraphQL 的对比1. REST核心理念是资源。服务端定义资源形式。资源的类型和获取资源的方法是紧密相关的。 REST 是多入口的，每个资源对应一个 URL，例如：http://api.test.com/books/，http://api.test.com/users/。 每个资源由后台定义好后，通过指定的一个 URL 访

GraphQL HTTP 服务器一般都可以处理 HTTP 的 POST 方法，有的还可以处理 GET 方法。1. GET 请求用 GET 请求查询 GraphQL 服务器时，应当将查询的文档，变量和操作名称作为 GET 参数传给服务器。 完整的参数格式：?query=查询文档&variables=变量&operationName=操作名称。query：查询文档，必填。variab