关于 API 你应该知道的一切

API（应用程序编程接口）是两个软件组件之间的连接器或中介。它提供一组明确的协议，使接口成为可能，定义了请求和响应的性质。开发人员通过 API 文档了解如何构建请求和响应。

简单来说，API 允许两个应用程序相互通信。例如，查看天气或在应用程序上发送和接收消息时，都在使用 API。

API 工作周期

当使用应用程序时，会发生以下步骤：

每次应用程序要求特定响应时，这个循环都会重复。

REST：REST（具象状态传输）是高度首选和采用的 API 架构类型。它依赖于客户端/服务器模型，分离了 API 的前端和后端部分，且不存储任何状态。
SOAP：SOAP（简单对象访问协议）主要用于创建基于 XML 的 Web API。它兼容多种通信协议，如 HTTP、TCP 和 SMTP。SOAP 的特点是高度结构化、标准明确，便于扩展和添加功能。
RPC：RPC（远程过程调用）能够执行可操作的任务，非常适合发送各种参数并接收相应的响应。

根据 API 的使用场景和访问权限，可以将其分为不同类型。企业应根据自身需求选择合适的 API 类型。

这种 API 仅限于拥有官方许可的授权客户端使用，通常用于与提供 API 的公司有业务关系的用户。合作伙伴 API 受到组织的青睐，因为它们可以对资源的使用方式和访问权限进行更大的控制。

合作伙伴 API 的优势：

公共 API 是完全开放的，任何外部开发者或企业都可以使用。适合那些愿意与公众或其他业务组织共享其应用程序和数据的企业。

公共 API 的优势：

内部 API（或私有 API）仅供企业内部使用，用于连接业务内部的数据。虽然内部 API 的安全性和身份验证相对较弱，但随着安全安排的改进，这一问题正逐步得到解决。

内部 API 的优势：

内部 API 的一个主要优势是，它可以帮助开发人员在更短的时间内制定和构建新应用程序。由于内部 API 连接了业务的不同部分，开发过程中的适应性和灵活性也得以提高。

复合 API 是两个或多个 API 的组合，集成了各 API 的最佳特性。它们通常带来更高的速度、灵活性和性能，从而提高了整体效率。

复合 API 的优势：

API通过函数调用实现，其任务是请求软件执行特定的操作或功能。当用户发起API调用时，它会通知应用程序执行相应任务，随后应用程序通过API与Web服务器通信并完成操作。

API基本上充当了应用程序和Web服务器之间的桥梁。因此，每当软件被指示执行任务或请求信息时，API便是实现这一过程的关键。日常生活中，API的应用举例包括PayPal支付、和风天气查询等。

函数调用由名词和动词组成，并在API文档中详细描述。API的主要任务是简化并加快软件开发过程。

沙盒 (Sandbox): 一种简单的RESTful API模拟工具，主要用于降低在测试期间调用第三方API的成本。
Apigee: 谷歌提供的Apigee工具，用于促进应用程序和服务之间的数据传输，是构建连接应用程序的理想选择。
APIMatic: APIMatic是一个开发者体验平台，专为网站API设计，在维护API更新方面表现灵活。它还支持将API描述转换为多种格式，如WADL、Swagger、RAML、OAI格式、IO Docs、API Blueprint、HAR 1.4、Postman Collections等。

构建API时，可参考以下五项最佳实践：

安全性: 使用基于令牌的身份验证来构建安全可靠的API。在确保安全性的同时，也要保持用户体验的友好性。
文档: 精心设计的API文档可以显著降低项目成本、提高效率并缩短实现时间。应创建详尽的API文档，使开发者能够清晰理解整个开发过程。
节流: 为应对流量溢出、预防DoS攻击以及备份API，应用程序节流是关键措施之一。合理的流量控制可保障API的稳定性和可靠性。
SDK和库: 提供必要的SDK和库资源，可以加快开发进程，让开发团队更高效地构建应用程序。
重写HTTP方法: 通过使用自定义HTTP头X-HTTP-Method-Override，允许RESTful API重写HTTP方法，解决某些代理只支持POST和GET方法的限制。