调用 GraphQL API 需要做的 4 件事

GraphQL 是 Facebook 开发的一种数据查询和操作语言。使用 GraphQL API 的过程不同于 REST 等其他类型的 API。

在开始之前，让我们快速了解一下 GraphQL 及其基础知识。

GraphQL

GraphQL 是一种查询语言，是数据查询和操作的 API 标准。使用 GraphQL，您可以精确地获得所请求的数据，不多也不少。此外，您只需使用一个入口点（即 /graphql）即可获取数据。

要理解 GraphQL 的工作原理，可以把它想象成一个图形。当用户提出请求时，它会公开图中的一条 “边”，即一个端点。这种特性使用户可以指定他们想要的东西，并得到准确的响应。因此，从服务器到客户端需要传输的数据量更少，从而提高了应用程序的性能和可扩展性。

在调用 GraphQL API 时，无论其实现方式如何，一般都需要指定四项内容。因此，请牢记以下事项。

1.HTTP 方法

API 使用 HTTP 方法来执行不同的操作。REST API 允许使用九种不同的 HTTP 方法向服务器发出请求。不过，对于 GraphQL API，我们主要只使用 POST 方法，并在请求正文中包含以下内容：

2.标头

我们必须为所有 GraphQL API 设置内容类型为 application/json 的标头。原因是我们使用查询从 GraphQL API 请求数据，而这些查询及其变量是以 JSON 格式发送的。

3.端点 URL

正如我们前面所讨论的，GraphQL 只提供一个端点，您可以使用查询来指定所需的内容。因此，我们需要为唯一的 GraphQL 端点指定 URL。

4.查询

在其他 API 标准（尤其是 REST）中，我们使用不同的 HTTP 方法和端点来获取所需的数据。在 GraphQL 中，我们使用查询来定义所需的数据。这些查询可以使用简短的语法，也可以使用自定义的命名操作和查询关键字。不过，最好使用命名查询。

# Shorthand syntax
users {
    name
}
# Named query
query getUsers {
    users {
        name
    }
}

最后，我们需要在 JSON 结构中指定包含请求和变量的查询。

希望本指南能帮助您了解在应用程序中调用 GraphQL API 的一些基本原理。