GraphQL 与 REST：选择正确的 API 风格

GraphQL 与 REST：选择正确的 API 方法

当您构建 API 时，两种主要方法是 REST 和 GraphQL。两者都被广泛使用，各有优缺点。正确的选择取决于您的具体需求——没有通用的赢家。

REST 的工作原理

REST 将您的 API 组织成资源——用户、订单、产品——每个都有特定的 URL。您使用 HTTP 方法指示您想要做什么。服务器决定为每个端点返回哪些数据。如果您需要用户的个人资料，您调用 /users/123 并获取服务器提供的任何内容。如果您还需要用户的订单，您可能需要单独调用。

REST 简单、易于理解，并且拥有出色的工具。缓存自然工作，因为每个 URL 代表一个特定的资源。HTTP 状态码提供清晰的反馈。无状态特性使其易于扩展。

GraphQL 的工作原理

GraphQL 采用不同的方法。不是多个端点，而是有一个单一的端点，您可以在其中发送描述您确切需要的数据的查询。服务器只返回这些数据，不多不少。如果您需要用户的姓名、电子邮件和最近五个订单，您在查询中指定这些，并在一个响应中全部获取。

GraphQL 是强类型的——模式精确地定义了哪些数据可用以及它们具有什么类型。这实现了强大的工具：API 资源管理器中的自动完成、发送请求前的验证以及自动文档生成。

各自擅长的场景

REST 非常适合简单的、面向资源的 API。如果您的数据模型简单，并且客户端通常需要相同的数据，REST 更简单、更高效。当您想利用内置在每个浏览器和 CDN 中的 HTTP 缓存时，它也更好。

当您有复杂的数据关系、多个具有不同需求的客户端，或者您正在构建带宽有限的移动应用时，GraphQL 表现出色。在一次请求中获取您确切需要的数据的能力非常强大。GraphQL 还使您无需版本控制即可轻松演进 API——您可以添加新字段而不会破坏现有客户端。

您可以同时使用两者

REST 和 GraphQL 并不互斥。许多团队对简单的、可缓存的资源使用 REST，对需要聚合多个来源数据的复杂查询使用 GraphQL。一些框架，如 Apollo，允许您从同一个后端同时使用两者。重要的是为每个特定用例选择正确的工具。

对于大多数项目，从 REST 开始。它更简单、易于理解，并且对许多应用来说已经足够。如果您发现自己遇到过度获取、欠获取或客户端需求快速变化的问题，GraphQL 值得投资。