完整指南：通过示例了解有关 API 的一切

待我称王封你为后i 2023-09-26 22:27 90阅读 0赞

什么是带有示例的 API？  
您之前可能听说过术语“API”。但这到底是什么意思，为什么重要？

简单来说，API（代表“应用程序编程接口”）是不同计算机程序相互通信的一种方式。可以把它想象成一个程序可以用来向另一个程序询问信息或要求它做某事的密码。

例如，您是否使用过允许您使用 Facebook 或 Google 帐户登录的网站或应用程序？当你这样做时，该网站或应用程序正在使用 API 与 Facebook 或谷歌的系统对话，并询问你是否真的是你。如果一切正常，该网站或应用程序可以让您进入。

另一个例子是天气应用程序。您可以使用手机上的天气应用程序来查看您所在地区的天气预报。但该应用程序本身实际上并不创建预报 - 它使用来自天气服务的 API 来获取信息。该应用程序向天气服务询问您所在地区的预报，天气服务以该应用程序可以理解的方式发回信息。

有各种各样的 API 用于各种各样的事物——社交媒体平台、在线商店、地图和导航等等。API 使不同的程序和服务可以协同工作，这就是它们在技术领域如此重要的原因。

男人，成人，商人

构建 API 时的心态？  
API 非常有用，因为它们使他们能够专注于构建项目所需的特定功能，而不必担心从头开始创建所有内容。通过使用 API，开发人员可以节省时间和资源，并构建更强大和创新的软件。

API 还可以让开发人员更轻松地协同工作。如果一个开发人员构建了一个执行特定功能的API ，其他开发人员就可以在他们自己的项目中使用该 API。这可以带来更快的开发、更好的协作以及整体上更成功的软件。

例如，开发人员可能会使用 API 将天气数据与交通数据结合起来，从而创建比任何一种服务都无法单独提供的功能更强大、更有用的应用程序。

有哪些不同类型的 API？  
有多种类型的 API，包括：

SOAP（简单对象访问协议）API： SOAP API 用于在 Web 服务的实现中交换结构化信息。SOAP 是一种使用 XML 作为格式在应用程序之间交换消息的协议。

XML-RPC API： XML-RPC 是一种远程过程调用 (RPC) 协议，它使用 XML 对其调用进行编码，并使用 HTTP 作为传输机制。它用于构建 Web 服务并允许客户端使用 HTTP 请求与服务器通信。

REST（具象状态传输）API： REST 是一种使用 HTTP 作为通信协议的架构风格。RESTful API 允许客户端使用 HTTP 请求（例如 GET、POST、PUT 和 DELETE）访问和操作 Web 资源。

JSON-RPC API： JSON-RPC 是一种轻量级远程过程调用 (RPC) 协议，它使用 JSON 作为编码其调用的格式，并使用 HTTP 作为传输机制。它用于构建 Web 服务并允许客户端使用 HTTP 请求与服务器通信。

GraphQL API： GraphQL 是 Facebook 开发的 API 查询语言。它允许客户端仅请求和接收他们需要的数据，使其比传统的 REST API 更高效。

OpenAPI（以前称为 Swagger）API： OpenAPI 是一种用于构建 API 的规范，允许机器可读的 API 文档。它用于描述 RESTful Web 服务，并提供一种自动生成客户端库和服务器存根的方法。

每种类型的 API 都有自己的优点和缺点，我们稍后会在另一篇文章中讨论，别忘了加入我们的邮件列表。回到类型：选择使用哪种类型取决于正在构建的应用程序或系统的特定需求。REST API 是目前最流行的 API 类型，因为它们简单、灵活且易于使用。

除了基于不同协议类型的 API 之外，还有基于 API 的用途和访问权限的不同类别或分类。以下是一些基于访问的主要 API 类型的概述：

公共 API：公共 API 可供任何人访问，可用于构建可供公众使用的应用程序。公共 API 的示例包括社交媒体 API、天气 API 和地图 API。公共 API 通常需要身份验证，但通常比其他类型的 API 更开放和灵活。

合作伙伴 API：合作伙伴 API 可供特定业务合作伙伴或客户访问，通常用于集成两个独立的系统或应用程序。合作伙伴 API 的示例包括支付网关 API 和运输 API。合作伙伴 API 通常比公共 API 更安全和更受控制，但仍然需要合作伙伴之间的身份验证和一定程度的信任。

内部 API：内部 API 在组织内使用，以实现不同部门或应用程序之间的通信。内部 API 的示例包括 HR API 和库存管理 API。内部 API 通常比合作伙伴和公共 API 更安全和受控，并且可能需要专业知识才能使用。

复合 API：复合 API 是通过将多个 API 组合在一起以创建一个新的、更复杂的 API 而创建的。这样做通常是为了提供比通过单个 API 提供的服务更加定制化或更具体的服务。与其他类型的 API 相比，复合 API 需要更高级的技术技能才能创建和使用。

B2B API： B2B（企业对企业）API 用于企业对企业的通信和集成。它们旨在促进两个独立企业之间的通信，并且通常比其他类型的 API 更安全和可控。B2B API 需要两个企业之间有一定程度的信任，并且可能需要专业知识才能使用。

了解这两种重要的数据格式（XML 和 JSON）  
如果您曾经使用过网站或应用程序，您可能遇到过 XML 或 JSON——开发人员用来在不同程序之间共享信息的两种流行数据格式。在本节中，我们将解释什么是 XML 和 JSON，以及它们为何重要。

XML  
XML（代表“可扩展标记语言”）是一种以结构化格式存储和共享数据的方法。它通常用于网站内容、在线表格和其他需要组织和易于阅读的数据类型。

在 XML 文档中，数据被组织成描述数据结构的“标签”和“元素”。例如，如果您要存储有关书籍的信息，您可能会使用“书名”、“作者”和“出版商”等标签来组织数据。

下面是一个 XML 文档的示例：

The Hitchhiker's Guide to the Galaxy Douglas Adams Pan Books JSON JSON（代表“JavaScript Object Notation”）是另一种存储和共享数据的方式，通常用于 Web 开发。与 XML 一样，JSON 也是结构化的，但它使用不同的语法。

在 JSON 文档中，数据被组织成描述数据结构的“键值对”。例如，我们在 XML 示例中使用的相同书籍数据在 JSON 中可能如下所示：

\{  
“title”: “The Hitchhiker’s Guide to the Galaxy”,  
“author”: “Douglas Adams”,  
“publisher”: “Pan Books”  
\}  
JSON 优于 XML 的一个优势是它在 Web 应用程序中解析（或读取）通常更快、更容易，因为它是一种更轻量级的格式。

精神，冥想，几何，解码

解码 REST API  
REST API 工作原理说明  
那么，REST API 是如何工作的呢？简单来说，REST API 是一组 URL（或“端点”），开发人员可以使用它们发送请求和接收数据。例如，如果您正在构建一个显示天气数据的应用程序，您可以使用 REST API 从天气服务获