什么是API？- Redocly

什么是API？

应用程序编程接口，是计算机程序之间相互通信的方式。通过API，不同的程序可以按照预定义的规则和格式交换信息，从而实现自动化任务的执行。为了更好地理解API的工作原理，我们可以通过一个简单的类比——邮件系统来说明。

API的类比：邮件系统

我们可以将API的工作方式类比为老式邮件系统中的邮箱。以下是具体的类比过程：

1. 信封与规则：
   一个信封必须包含投递地址、回邮地址以及正确的邮票。这些规则确保信封能够被邮政系统识别和处理。同样，API也有一套“合同”，即对请求的格式和内容的要求。

2. 信封的内容：
   假设信封里装的是笔记本电脑贴纸，从奥斯汀寄到利沃夫。信封被放入邮箱后，邮政系统会按照既定流程处理信件，直到它被送达目的地。

3. 自动化与效率：
   如果没有邮政系统，寄送信件可能需要亲自完成，耗费大量时间和金钱。而通过邮政服务，只需支付少量邮费即可完成任务。类似地，API通过自动化任务，极大地提高了效率。

API的基本组成

API的运行涉及以下几个关键角色和步骤：

1. 消费者（客户端）：
   消费者是发出请求的一方，就像将信封放入邮箱的人。

2. API（服务端）：
   API是接收请求并产生响应的一方，类似于邮件服务。

3. 请求与响应：
   消费者根据API的定义发送请求，API根据请求执行任务，并返回相应的结果。

4. Webhook通知：
   API可以通过webhook向订阅者发送通知，就像邮件系统会将信件投递到收件人的邮箱。

API的“合同”与限制

API的“合同”类似于邮件系统的规则，确保任务能够顺利完成。以下是一些常见的限制：

• 格式要求：请求必须包含正确的参数和格式，例如投递地址和回邮地址。
• 大小和重量限制：请求的内容不能超出API允许的范围。
• 错误处理：如果请求不符合“合同”，API可能会返回错误消息。

例如，如果信封邮费不足，信件可能会被退回；如果信封太小，可能会丢失。

API的运行时注意事项

在实际使用中，API还需要考虑以下运行时因素：

1. 身份验证和授权：
   确保只有被授权的用户可以访问API。例如，我可以将信件放入自己的邮箱，但不能放入他人的邮箱。

2. 费率限制：
   限制API的使用频率，例如邮箱的容量限制。

3. 服务级别协议（SLA）：
   确保API在一定时间内完成任务，例如邮件在规定时间内送达。

这些运行时注意事项对于API的可靠性和安全性至关重要。

API的价值

API的价值在于它能够高效地完成特定任务。例如，通过API，我们可以快速预订航班、酒店等服务，而无需手动操作。相比于传统方式，API不仅节省了时间和成本，还降低了出错的风险。

总结

API是现代计算机程序之间通信的核心工具。通过API，程序可以按照预定义的规则高效地交换信息，完成复杂的任务。无论是邮件系统还是API，它们的核心都是通过标准化的接口实现自动化和高效性。希望通过本文的类比，您对API的工作原理有了更清晰的理解。

原文链接: https://redocly.com/blog/whats-an-api