了解和使用 REST API

Desknumber

如果您希望能够阅读 API 文档并有效地使用它们，您首先需要了解有关 REST API 的所有内容。让我们开始吧。如果您考虑过从互联网上的其他来源（例如 Twitter 或 Github）获取数据，那么您很可能会遇到“REST API”一词。但什么是 REST API？它能为您做什么？你如何使用它？

在本文中，您将了解有关 REST API 所需的所有信息，以便能够阅读 API 文档并有效地使用它们。

假设您正在尝试在 YouTube 上查找有关蝙蝠 电子邮件营销列表 侠的视频。你打开 Youtube，在搜索字段中输入“蝙蝠侠”，然后按 Enter 键，你就会看到有关蝙蝠侠的视频列表。REST API 以类似的方式工作。您搜索某些内容，然后从您请求的服务返回结果列表。

API是应用程序编程接口。它是一组允许程序相互对话的规则。开发人员在服务器上创建 API 并允许客户端与其对话。



REST决定了 API 的外观。它代表“代表性状态转移”。这是开发人员在创建 API 时遵循的一组规则。其中一条规则规定，当链接到特定 URL 时，您应该能够获取一段数据（称为资源）。

该路径决定了您请求的资源。可以将其想象为自动应答机，要求您按 1 获取一项服务，按 2 获取另一项服务，按 3 获取另一项服务，依此类推。

要了解哪些路径可供您使用，您需要查看 API 文档。例如，假设您想通过 Github 的 API 获取某个用户的存储库列表。该文档告诉您使用以下路径来执行此操作：

端点的最后部分是查询参数。从技术上讲，查询参数不是 REST 架构的一部分，但您会看到许多 API 使用它们。因此，为了帮助您完全理解如何阅读和使用 API，我们还将讨论它们。查询参数使您可以选择使用键值对修改请求。它们总是以问号 ( ?) 开头。然后，每个参数对用 & 符号 ( ) 分隔&，如下所示。