API – 什么是 API？

API（应用程序编程接口）是一组用于在两个应用程序之间进行通信的规则和规范。简单来说，API 允许一个程序与另一个程序交互。例如，您可以创建一个应用程序，让用户通过微信或 QQ 相互发送消息。在幕后，您可以使用微信API 将此功能集成到您的应用程序中，并使用自动化来实现这些 API 调用。

API到底是什么？ API 有什么作用？

API 代表什么？

API代表应用程序编程接口。 API是应用程序编程接口的缩写，是一组定义和协议，允许技术产品和服务通过物联网 (IoT) 相互通信。

API 有何用途？

如果您是一名初学者程序员，您可能想知道 API 的定义是什么。 API（应用程序编程接口）允许您的应用程序使用一组简单的命令与外部服务交互。从名称上看，“接口”是不同软件组件可以交互的地方。使用 API允许开发人员向其应用程序添加特定功能，并可以加快开发过程。

您每天使用的大多数 Web 应用程序在某种程度上都依赖于 API。几乎所有可以想象到的类别都有 API，从数据到旅行，甚至体育。例如，许多应用程序不会投入时间和资源来创建自己的支付处理系统，而是使用易宝等支付处理 API。

API 就像构建块一样，使开发人员能够更快地构建应用程序。它们还可以防止开发人员“重新发明轮子”并花时间创建已经存在的功能。

API 有什么作用？

简而言之，API 充当两个或多个应用程序之间的中间人，接受消息并返回响应。在开发复杂的应用程序时，我们在服务器上编写所有数据操作代码，客户端用户无法访问这些代码。这主要是出于安全原因。服务器是托管在其他地方的独立应用程序。

要从服务器获取数据，我们必须使用服务器的API。 API 将根据客户端的身份验证级别向客户端返回响应。

API 不仅仅用于获取数据。它还可用于在服务器上创建、删除或交换数据。

API 有何用途？初学者API说明：

本质上，API 允许两个软件程序相互通信。一个程序可以调用另一程序的 API 来访问另一程序的数据或功能。

要准确了解 API 的工作原理，请考虑这个非技术示例。当你去餐厅时，服务员会接受你的订单并报告给厨房。厨房为您准备食物，服务员将其带回到您的餐桌上。

在此示例中，一个程序是您（点餐的人），一个程序是厨房。服务员代表用于接收请求并返回某些内容的 API。在这种情况下，服务员会返回您的订单，但实际的 API 将返回数据或其他功能。

API 的一些示例有哪些？ API 示例和用例

现在我们对 API 有了基本的了解，应该更容易理解为什么 API 在编程中如此重要。对于一个稍微更技术性的示例，请考虑 API 如何使用乘车共享应用程序作为示例来发挥作用。首先，您注册乘车共享应用程序。然后，您无需离开应用程序即可绘制路线、找到司机并支付行程费用。

拼车应用程序很可能使用 API 来完成所有这些工作。例如，像手机号验证这样的 API可以验证您是否拥有注册时提供的电话号码。计算骑行时间和距离可能是通过地图 API完成的。像短信通知这样的 SMS API可以通知您司机已到达上车地点。当需要付款时，您的付款可能会通过支付宝等 API 进行处理。最后，通过电子回单 API将乘车收据发送到您的邮箱。

这是如何结合使用 API 来快速向应用程序添加功能的一个示例。要查看其他 API 示例，请访问 API Hub。

什么是微服务？

微服务是一种架构风格，它将应用程序构建为小型、独立且松散耦合的服务的集合。每个微服务都旨在执行特定的业务功能，并且可以通过轻量级协议（例如 HTTP 或消息系统）与其他微服务进行通信。

微服务通常独立部署，并且可以水平扩展，从而实现更大的灵活性和弹性。只要它们遵守通用的通信协议，就可以使用不同的技术和编程语言来开发和部署它们。

使用微服务架构的好处包括更快的开发和部署时间、改进的可扩展性、更好的故障隔离以及更轻松的维护和更新。然而，实现微服务架构还需要仔细的设计和管理，以确保服务之间正确的通信和协调。

有哪些不同类型的 API？

从架构上来说，API有五种类型：

REST API： REST API 允许您在客户端和服务器之间执行 CRUD（创建、读取、更新和删除）操作。它提供了多个 API 端点来操作数据。
GraphQL API：它是一种查询语言，允许客户端从服务器请求他们所需的精确数据。因此，消除了其他操作系统中出现的获取不足和过度获取的问题。
SOAP API：任何符合 SOAP Web 服务 API规范的 Web 服务都是 SOAP Web 服务。
Kafka API： Apache Kafka 是一个事件流平台，它结合了三种功能，以便您可以实现不同的用例。这三种功能是发布和订阅事件流、持久可靠地存储事件流以及在事件流发生时对其进行处理。
异步 API：这些 API 遵循事件驱动架构 (EDA) 的原理。在 AsyncAPI 中，多个订阅者可以订阅一个发布者。当事件发生时，发布者（API 提供者）可以通过消息代理通知所有订阅者。

在访问方面，API主要有四种类型：

开放 API：也称为公共 API。这些 API 是公开可用的，并且访问它们没有任何限制。
合作伙伴 API：这些 API 不公开，因此您需要特定的权利或许可才能访问它们；一个很好的例子是企业与业务合作伙伴共享 API，以利用 API 功能提供业务价值。
内部 API：也称为私有 API。这些 API 通常供公司内部使用，并且仅由内部系统公开。公司可以在不同的内部团队中使用这种类型的 API，以改进其产品和服务。
复合 API：这些 API 组合了不同的数据和服务 API。它是作为执行结果同步运行的任务序列，而不是根据任务的请求同步运行。此类 API 的主要目的是加快执行过程并提高 Web 界面中侦听器的性能。

什么是 Web 服务 API？

除了主要的Web API之外，还有 Web 服务 API。 Web 服务是使用地址（例如万维网上的 URL）提供对其服务的访问的系统或软件。最常见的 Web 服务 API 类型包括：

SOAP（简单对象访问协议）：这是一种使用 XML 作为传输数据的格式的协议。它的主要功能是定义消息的结构和通信方法。它还在机器可读文档中使用 WSDL（Web 服务定义语言）来发布其接口的定义。
XML-RPC：这是一种使用特定 XML 格式传输数据的协议，与使用专有 XML 格式的 SOAP 相比。它也比 SOAP 更古老。 XML-RPX 使用最小的带宽并且比 SOAP 简单得多。
JSON-RPC：该协议与 XML-RPC 类似，但它不使用 XML 格式来传输数据，而是使用JSON。
REST（表述性状态传输）： REST 不是像其他 Web 服务那样的协议。相反，它是一组架构原则。 REST 服务需要具有某些特征，例如简单的接口，这些特征是在请求中易于识别的资源。

什么是 Webhook API？

还有另一种类型的 API，称为 Webhook API。Webhook API 的功能与传统 REST API 的工作方式类似，但方向相反。通常，您编写一个程序来执行 API 调用并从该 API 获取响应。在某些情况下，您不想调用 API；您只是希望 API 在发生某些情况时通知您。

计费系统就是一个例子。您不希望不断向 API 发出请求来查看是否已付款。相反，您可以使用 Webhook API 在每次付款时通知您。

SOA 与微服务架构

SOA和微服务是用于开发具有远程 API 的分布式系统的两种方法。 SOA 将功能分解为松散耦合的组件，而微服务则创建使用轻量级协议进行通信的专用、独立的服务。虽然 SOA 比整体架构更简单，但它会带来额外的复杂性。微服务支持更快的功能交付和动态可扩展性，但需要仔细管理以避免数据不一致和性能问题等潜在问题。这两种方法都有其优点和缺点，开发人员必须选择最适合其应用程序需求的架构。

什么是 API 管理？

API 管理是指设计、发布、保护、监控和分析 API（应用程序编程接口）以最大限度地发挥其价值和潜力的过程。它涉及各种工具、技术和流程，使组织能够跨多个应用程序、平台和设备控制和优化 API 的使用。有效的API 管理可确保 API 可访问、可发现且安全，同时还提供有关 API 使用、性能和行为的见解。 API 管理是现代软件开发的一个重要方面，使组织能够利用其 API 来创建新产品、服务和收入流。

什么是API文档？

API 文档是 API 管理的一个重要方面，涉及为开发人员创建有关如何有效使用 API 的综合指南。文档应该清晰、简洁、最新，并包含代码示例和简单语言的解释，以帮助初学者理解 API 功能。好的 API 文档还应该涵盖 API 可以为用户解决的所有问题，并确保他们拥有使用 API 所需的所有信息。通过遵循这些最佳实践，开发人员可以创建有效的 API 文档，帮助用户成功集成和使用 API。