什么是 API（应用程序编程接口）？

API 架构通常从客户端和服务器的角度来解释。发送请求的应用程序称为客户端，发送响应的应用程序称为服务器。以天气为例，气象局的天气数据库是服务器，而移动应用程序是客户端。 

API 有四种不同的工作方式，具体取决于其创建时间和创建原因。

SOAP API 

这些 API 使用简单对象访问协议。客户端和服务器使用 XML 交换消息。这是一个不太灵活的 API，它在过去比较流行。

RPC API

这些 API 称为远程过程调用。客户端在服务器上完成函数（或过程），而服务器将输出发回客户端。

Websocket API

Websocket API 是另外一种使用 JSON 对象传递数据的现代 Web API 开发方式。WebSocket API 支持在客户端应用程序和服务器之间进行双向通信。服务器可以向连接的客户端发送回调消息，使其比 REST API 更高效。

REST API

这些是如今最流行、最灵活的 Web API。客户端以数据形式向服务器发送请求。服务器使用该客户端输入来开始执行内部函数，并将输出数据返回到客户端。下面让我们进一步了解一下 REST API。

Web API 或 Web 服务 API 是 Web 服务器和 Web 浏览器之间的应用程序处理接口。所有 Web 服务都是 API，但不是所有 API 都是 Web 服务。REST API 是一种特殊类型的 Web API，它采用上面介绍的标准架构样式。

从历史上来看，与 API 有关的各种术语（如 Java API 或服务 API）之所以存在，是因为 API 是在万维网出现之前创建的。现代 Web API 是 REST API，而且这些术语可以换用。

REST API 有四大优势：

1.集成 

API 用于将新应用程序与现有的软件系统集成。这可以提高开发速度，因为不必从头开始编写每个功能。您可以通过 API 来利用现有代码。

2.创新 

一款新应用程序的出现可能会给整个行业带来变化。企业需要快速响应并支持快速部署创新型服务。他们可以通过在 API 级别进行更改来做到这一点，而无需重新编写所有代码。

3.扩展

API 可为企业提供独特机会，从而跨不同平台满足客户的需求。例如，地图 API 允许通过网站、Android、iOS 等平台整合地图信息。任何企业都可以通过使用免费或付费 API 来提供类似的内部数据库访问权限。

4.易于维护

API 充当两个系统之间的网关。每个系统都必须进行内部更改，以便 API 不会受到影响。这样，一方未来对代码做出的任何更改都不会影响另一方。

API 端点是 API 通信系统中的最终接触点。其中包括服务器 URL、服务和其他特定数字位置，通过这些端点可在系统之间发送和接收信息。API 端点对企业至关重要，主要有以下两个原因： 

1.安全性

API 端点使系统容易受到攻击。API 监控是防止滥用的关键。

2.性能

API 端点（尤其是高流量端点）可能会引发瓶颈并影响系统性能。

要构建其他开发人员愿意使用并信任的 API，需要尽职尽责并付出努力。以下是设计优质 API 所需的五个步骤：

1.规划 API 

API 规范（如 OpenAPI）可为 API 设计提供蓝图。最好提前考虑不同的使用场景，并确保 API 符合现有的 API 开发标准。

2.构建 API

 API 设计人员使用样板代码进行 API 原型设计。原型通过测试后，开发人员可以根据内部规范对其进行定制。

3.测试 API  

API 测试与软件测试相同，必须进行测试以防止错误和缺陷。API 测试工具可用来进一步测试 API 应对网络攻击的能力。

4.编写 API 文档  

虽然 API 不言自明，但 API 文档可充当提高可用性的指南。妥善编写文档的 API 可提供一系列功能和使用场景，在面向服务的架构中往往更受欢迎。

5.将 API 推向市场 

Amazon 是零售领域的在线市场，而 API 市场则为开发人员提供了购买和销售其他 API 的平台。上架您的 API，以便通过它获利。

编写全面的 API 文档是 API 管理流程的一环。API 文档可以使用工具自动生成，也可以人工编写。部分最佳实践包括：

• 用简单易懂的英文表达编写说明。工具生成的文档可能会比较冗长，需要编辑。
• 使用代码示例来说明功能。
• 维护文档，使其准确并保持最新状态。
• 编写文档时要充分考虑新手
• 说明 API 可以为用户解决的所有问题。

可以在 API 市场和 API 目录中找到新的 Web API。API 市场是一个开放的平台，任何人都可以在这里上架 API 来出售。API 目录是受目录拥有者监管的受控存储库。专业 API 设计者在将新 API 添加到他们的目录之前，可能会对其进行评估和测试。  

部分热门 API 网站包括：

• Rapid API – 全球最大的 API 市场，拥有 10000 多个公有 API 和 100 万名在线活跃的开发人员。RapidAPI 允许用户在购买之前直接在平台上测试 API。
• Public APIs – 该平台将远程 API 分为 40 个细分类别，让您更轻松地浏览并找到符合自己需求的相关 API。
• APIForThat 和 APIList – 这两个网站提供包含 500 多个 Web API 的列表，并深入介绍了这些 API 的使用方法。    

GraphQL 是一种专门为 API 开发的查询语言。它只是为了优先为客户端提供所请求的确切数据。它旨在提高 API 速度和灵活性，并便于开发人员使用。作为 REST 的替代方案，GraphQL 为前端开发人员提供通过单一 GraphQL 端点查询多个数据库、微服务和 API 的功能。 各家企业都选择使用 GraphQL 构建 API，因为它有助于加快应用程序开发速度。 在此进一步了解 GraphQL。

AWS AppSync 是一项完全托管式服务，通过处理与 AWS DynamoDB、AWS Lambda 等数据来源之间繁重的安全连接任务来开发 GraphQL API 等，并且 AWS AppSync 可以通过 Websocket 向数百万客户端推送实时数据更新。对于移动和 Web 应用程序，AppSync 还可以在设备离线时提供本地数据访问权限。部署之后，AWS AppSync 会自动扩展和缩减 GraphQL API 执行引擎以满足 API 请求量需求。