Restful API vs GraphQL API - 针对 API 新人的简介

在开发前端应用程序时，必须考虑到与后端的通信。为了实现这种通信，Web 开发人员通常使用 API（应用程序编程接口）。目前，最常用的 API 是 Restful API 和 GraphQL API，那么它们之间有什么不同呢？

Restful API

Restful 是一种设计 API 的风格，主要基于以下几个特点：

• 每个 URL 表示一个资源
• 使用 HTTP 动词（GET、POST、PUT 和 DELETE）进行操作
• 客户端和服务器之间无状态

Restful API 的优点之一是它的简单性。它非常适合资源的 CRUD（Create、Read、Update 和 Delete）操作，但是当客户端需要读取与一个资源相关联的其他信息时，就需要发送多个请求。此外，Restful API 的响应格式通常是 JSON 或 XML。

以下是一个简单的 Restful API 示例：

GET /api/books/1234

这个请求将返回 ID 为 1234 的书籍信息。

GraphQL API

GraphQL 是一种新的 API 标准，它是由 Facebook 在 2015 年引入的。GraphQL 旨在解决 Restful API 的一些缺点，例如需要多次请求才能获取所需数据。

GraphQL API 主要通过单个端点来进行数据查询、修改和订阅。客户端可以定义它们所需的数据结构，服务器会返回与该结构匹配的数据。与 Restful API 不同，GraphQL API 的响应格式可以是任何格式，如 JSON、HTML 或文本。

以下是一个简单的 GraphQL API 示例：

query {
  book(id: "1234") {
    title
    author
  }
}

这个查询将返回 ID 为 1234 的书籍的标题和作者信息。

Restful API vs GraphQL API

现在，让我们来看看 Restful API 和 GraphQL API 的具体区别：

• Restful API 通常适合资源的 CRUD，而 GraphQL API 则适合关联和嵌套的数据模型。
• Restful API 虽然简单，但当客户端需要读取关联的额外信息时，需要发送多次请求；而 GraphQL API 可以像 SQL 一样查询所有相关数据。
• Restful API 的响应格式通常限于 JSON 或 XML，而 GraphQL API 的响应格式可以是任何格式。此外，GraphQL API 还支持订阅功能，用于实时数据推送。

结论

因此，当您需要进行 CRUD 操作时，最好使用 Restful API。但是，如果您需要读取复杂的关联数据或需要订阅实时数据，则应选择 GraphQL API。

希望这篇文章能够帮助你初步了解 Restful API 和 GraphQL API。当您选择使用哪种 API 时，请仔细考虑您业务的需求，并根据实际情况做出选择。

参考文献

• RESTful API vs GraphQL, a Beginner’s Guide - AxiomQ
• What is GraphQL?

来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/670ce2d55f551281025bef7b