GraphQL 与 REST

GraphQL 通常被标榜为 REST API 的替代品。这一部分将举例说明 GraphQL 和 REST 之间的主要差异，也会介绍两者如何共存与互补。

GraphQL 与 REST：示例

假设你有一个抓取用户个人信息及其地址的 API。在典型的 REST 情境中，请求/响应如下所示：

GraphQL API 示例

REST API 的核心围绕资源展开。资源由 URL 和请求类型（GET、POST 等）识别。

如果你的 API 服务器以前是 GraphQL 服务器，则你的 API 调用将类似于：

GraphQL API 示例

可以看到，对于客户端发送的不同“查询”，响应 JSON 是不同的。

Request1:         |  Response1:

query {           |  {
  user (id: 1) {  |    "user": {
    id            |       "id": 1
  }               |     }
}                 |  }

----------------------------------------

Request2:         |   Response2:

query {           |   {
  user (id: 1) {  |     "user": {
    id            |       "id": 1
    name          |       "name": "Elmo"
  }               |     }
}                 |   }

培养 GraphQL 思维

我们正在改变我们对 API 调用的看法。我们根据查询对返回数据的“单一 URL 端点”进行临时查询，而不是对不同的 URL 发出不同的 API 调用以获取数据。

'POST' 一条描述你需要的数据的查询，而非 'GET' 资源。
将你的 API 返回的数据视作一个“图表”，这支持你进行查询，从而一次性抓取“相关”数据片段。在上述示例中，你在同一个 API 调用中抓取用户及该用户的地址（作为嵌套 JSON 对象），而不是发出两次 API 调用。
你在 POST 请求中作为数据发送的“查询”含有结构和语法。该“语言”被称为 GraphQL。

如上面的例子所示，GraphQL 查询非常简洁而且易读！这是因为查询是你想要的最终 JSON 数据的“形状”。这是使用 GraphQL 趣味十足的一个关键原因！

GraphQL 的优势

避免过度抓取：要避免抓取多于你需要的数据，因为你可以指定你需要的具体字段。
防止多次 API 调用：如果需要更多数据，也可以避免多次调用你的 API。在上述用例中，你不需要发出两次 API 调用，以分别抓取user和address。
减少与 API 开发者的通信费用：有时候为了抓取你需要的确切数据，特别是如果你需要抓取更多的数据并希望避免多次 API 调用，则需要要求 API 开发者创建一个新 API。借助 GraphQL，你即可独立于 API 团队开展工作！这有助于你更快地开发你的应用程序。
自文档化：每个 GraphQL API 均符合一个“模式”，即图表数据模型和客户端可以发出哪些类型的查询。这种功能支持社群开发大量酷炫的工具，以探索并可视化你的 API，或创建自动完成 GraphQL 查询、甚至执行“代码生成”的 IDE 插件。我们稍后会更详细地介绍这一点！

以下是一个简单图表，列出了典型的 REST 式术语的 GraphQL 类似术语：