什么是 API？ [快速阅读]

已发表: 2020-04-25

如果您不是开发人员，但您从事技术工作，那么 API 一词可能是您从对话意义上理解的。 您可能知道它代表什么（应用程序编程接口），并且您的团队可能使用 API 来完成他们的工作，或者甚至可能是产品本身（例如 Twilio SendGrid）。

但究竟什么是 API 以及它们是如何工作的？

了解 API 背后的更深层原理将帮助您更好地营销、销售或自己使用这些技术。

这篇文章解释了 API 的工作原理、开发人员如何构建它们以及如何使用它们（通过实际示例）。

API 是如何工作的？

Web 浏览器如何与服务器交互是 API 的基本原则。 网络是分散在地球上的远程服务器的集合。 当您打开浏览器并输入网站时，浏览器正在调用客户端的服务器（托管网站的任何应用程序或服务器）以获取并显示该 URL 上的任何内容。

虽然 API 不是服务器本身，但它是服务器的一部分，称为端点，它发送和接收某些响应。 API 是不同软件通过开放端点相互通信（也称为发送和接收）的一种方式。

开发人员在构建应用程序或网站时设置 API 调用来检索各种目的所需的特定数据。 例如：

  • 您刚刚打开您的 Instagram 应用程序吗？ 这是通过 API 调用实现的。
  • 您是否曾从其他网站或电子邮件将活动添加到您的 Google 日历？ 该网站利用 Google Calendar API 从 Google Calendar 服务器获取特定信息。

要点：开发人员设置 API 调用以检索特定数据类型，以在用户访问网站或运行应用程序时显示他们需要的内容。

REST 的兴起

您可能听说过的另一个术语是 REST API。 它与传统的 API 定义没有什么不同。 仍然值得了解为什么 REST API 变得如此流行以及 REST API 与其他 API 的区别。

最初，API 是为了满足 SOAP（简单对象访问协议）的要求而构建的。 但是这种方法有点乏味，并且需要大量的带宽来传输数据集。 它还需要大量的开发人员精力（就像不是那种有趣的那种）。 SOAP 使用众所周知的繁重的 XML 标记语言来显示数据。 对于确保通用兼容性很有用——但仅此而已。

开发人员一直在寻找更轻、更灵活的 API 调用方式。 REST（表示状态传输）API 提供了 SOAP API 的替代解决方案。 它们不受特定协议的限制，尽管它们必须满足某些架构风格（如果您有兴趣深入研究，请前往此处）。

服务器不使用 XML 标记显示，而是使用轻量级 JSON 语言（只是文本文件）。 REST API 的带宽比 SOAP 轻得多——它们通常只是一个 URL——它们自然而然地针对 Web 上的通信进行了优化。

要点：将 REST API 视为数据的 Marie Kondo。 他们只*精确地*使用他们需要的东西。 SOAP API 就像你邻居的车库，现在被卫生纸塞得满满当当。

了解不同类型的 API

无论 API 遵循什么协议或样式，都有几种类型的 API，包括：

  • 开放 API——也称为公共 API，任何开发人员都可以访问这些端点，并且通常不会对用户施加任何限制。 他们通常接受捐款。
  • 合作伙伴 API——这些 API 旨在一起使用，通常只能由某种市场访问。
  • 内部 API——这些是公司用来帮助员工提高效率或为员工提供更安全的数据/信息共享方式的内部工具。
  • 复合 API – 复合 API 是一种整合相关但通常需要单独 API 调用的 API 调用的方法。

API 的真实示例

有大量的 API（有些超过 15,000 个）可以帮助用户访问各种应用程序。 以下是一些值得注意的内容，可帮助您了解 API 生态系统的范围。

鸡尾酒数据库

假设您拥有一家当地的酒类商店，并且您想在您的网站上提供鸡尾酒食谱。 您可以考虑使用上面的 Cocktail DB API。 所有这些数据（鸡尾酒配方）已经存在于其他人的服务器上，并且可以通过 API 进行评估。

当用户点击玛格丽塔食谱（可以说是高级鸡尾酒）时，他们的服务器会发现特定的食谱以 JSON 格式发送出去，它会被网站拾取并解析为 HTML 和 CSS，以便在您的网站浏览器上显示。

打开天气地图

向您的网站添加天气部分是一个非常常见的用例。 想想任何滑雪胜地、自行车商店或旅游公司。 OpenWeatherMap API 存储所有天气预报和信息，并仅显示您请求的部分。

此 API 提供免费和高级版本，具体取决于您要显示的数据量。

SendGrid 电子邮件 API

SendGrid 电子邮件 API 利用 SMTP（简单邮件传输协议）允许客户发送大量事务性和触发式电子邮件——例如密码重置、帐户确认和发货通知。

Twilio 短信

Twilio SMS API 是另一个 REST API，它提供了一种向应用程序添加消息传递功能的方法。 SMS 消息作为品牌与客户沟通的一种方式变得越来越流行，因为它是个人的、实时的，并且这些消息的阅读率要高得多。

如何使用 API

在您或您的团队开始使用 API 之前，了解它们是开放的、与合作伙伴服务结合使用还是组合使用非常重要。

如何开始使用 API

阅读文档。 任何 API 都应该有适用的文档供您遵循。 它会告诉你有哪些依赖项、它是什么类型的 API 以及如何使用它。 对于您和您的开发人员来说，糟糕的文档应该是一个危险信号。 我们为 Twilio 和 SendGrid 的出色文档感到非常自豪。

生成 API 密钥。 您需要生成一个 API 密钥才能开始使用它。 以下是来自 Google Maps API 的说明：

注意：切勿共享 API 密钥，并确保它们在您放在 GitHub 上的任何公共代码中不可见。

开始构建：使用 SendGrid 电子邮件 API 免费发送电子邮件

剩下的就看你了！ 当您使用 API 时，机会真的是无穷无尽的。 要查看使用 Twilio API 的所有机会，请查看 Twilio 代码交换。

如果您对使用 SendGrid 电子邮件 API 发送免费电子邮件感兴趣，请在此处查看。