构建 Web API 的两种流行选择：REST vs GraphQL _Web

在 RESTful 和 GraphQL API 之间的选择取决于您的具体用例。RESTful API 适用于需要高可伸缩性的简单应用程序，而 GraphQL 则适用于具有不同数据需求的复杂应用程序。简介RESTful 和 GraphQL API 是构建 Web API 的两种流行选择，各有其优势和劣势。让我们更近距离地了解一下 RESTful 和 GraphQL API，它们的区别，以及在何时选择其中一种。
RESTful API 已经存在了一段时间，并且通常被广泛使用，而 GraphQL 是近年来变得流行的较新技术。

文章插图
第一部分：什么是 RESTful API？RESTful API 遵循一组规则和约束，规定了 API 应该如何设计。
1.使用标准的 HTTP 方法它们使用标准的 HTTP 方法，例如 GET、POST、PUT、PATCH 和 DELETE，对资源执行操作，数据通常以 JSON 格式返回。

文章插图
2.是无状态的RESTful API 是无状态的，这意味着服务器不会在请求之间存储任何客户端上下文。相反，每个请求都包含服务器处理所需的所有信息。这使得 RESTful Web 服务高度可伸缩，因为它们可以处理大量请求而无需为会话管理负担。

文章插图
3.具有 URL 约定RESTful URL 命名约定的主要原则之一是在 URL 路径中使用名词而不是动词。例如，不适合使用 /get-user-profile 这样的 URL，更适合使用 /users/{user_id}/profile 。该 URL 使用名词 users 表示用户资源的集合，并使用路径参数 user_id 来标识要访问的特定用户资源。

文章插图
第二部分：什么是 GraphQL？GraphQL 是一个用于 API 的查询语言，允许客户端定义其需要的数据的形状和结构。使用 GraphQL，客户端可以向服务器发出单个请求，并准确获取它们要求的数据，而没有其他多余的数据。
1.提供单个端点与 RESTful API 不同，GraphQL 提供一个单个端点，通常是 /graphql，它始终接受 POST 请求。客户端向此端点发送单个请求，服务器将根据通过请求体发送的查询或变更响应请求的数据。

文章插图
这种方法使得管理和版本化 API 变得容易，因为所有更改都可以在一个地方进行。
2.是无状态的GraphQL API 也是无状态的，服务器不存储任何客户端数据，每个请求都包含请求查询中的所有信息。

文章插图
第三部分：比较 RESTful 和 GraphQL APIRESTful 和 GraphQL API 在设计和查询 API 方面采用不同的方法。让我们根据一些关键因素进行比较：
1.数据获取RESTful API 遵循严格的请求-响应循环，其中来自客户端的每个请求都导致服务器的单个响应。这意味着客户端通常需要进行多个请求，从服务器获取相关数据，从而导致过度获取或不足获取数据。
GraphQL 相反，允许客户端仅请求他们需要的数据，而不是其他多余的数据。客户端可以指定他们需要的数据的结构，服务器会准确返回该数据，减少过度获取和不足获取数据。

文章插图
2.模式定义在 RESTful APIs 中，服务器定义数据模式，客户端需要解析返回的数据以理解模式。这可能导致客户端和服务器之间的耦合，因为服务器上的模式更改需要在客户端上进行相应的更改。
GraphQL 相反，具有强类型模式，定义了 API 中可用的数据。客户端可以使用此模式验证其查询并理解它们接收到的数据，减少客户端和服务器之间的耦合。

文章插图
3.缓存RESTful API 使用 HTTP 缓存头具有内建的缓存机制。这允许客户端缓存响应并避免向服务器发出不必要的请求。
GraphQL 没有内建的缓存机制，但客户端可以使用第三方库实现缓存策略。

文章插图
4.性能RESTful API 在客户端需要多次请求相关数据时可能遇到性能问题。这可能导致增加的延迟和网络流量。
GraphQL 通过**在单个：
请求中仅获取所需数据**，可以提高性能并减少网络流量。但是，如果不小心，优化不良的查询可能会导致更多性能问题，并严重影响服务器。从这个角度来看， GraphQL 的最大优势也可能是它的最大劣势。