# API：什么是应用程序编程接口？

> API是什么？API就是让两个软件自动交换数据的约定。本文用魁北克中小企业的实际数字示例，讲清API的原理，并列出常见错误，帮助您看懂软件互联，告别重复录入，少走弯路。

更新于 2026年10月15日 · https://app.pilotiko.com/zh/glossary/api

API（application programming interface，应用程序编程接口）是一个软件对外开放的一组功能和规则，让另一个程序无需通过用户界面，就能以自动化方式与它交互。它就像一份约定：知道该请求什么、以什么形式请求，以及将收到什么。

## 要点
- API是给程序用的，不是给人用的：它取代手工录入。
- 一次明确的请求，一个可预期的响应：这就是约定。
- API在被查询时才作出回应；Webhook则会主动通知。
- 每一次访问都应当受限、可识别、可撤销。

## API逐字是什么意思？

API源自英文“application programming interface”。MDN Web Docs（Web开发者的权威参考文档）将其描述为一组功能和规则，允许以自动化方式而不是通过用户界面与软件交互，并把它比作提供API的软件与其他程序之间的一份约定 [1]。

在浏览器中，API可用于访问摄像头或地理定位等。在企业之间，API可以让预订网站读取日程表中的空闲时段，或让会计软件接收来自管理工具的发票 [1]。

## 通过API进行数据交换是怎样进行的？

1. **客户端程序表明身份** — 它出示一个密钥或令牌，证明自己有权调用该API。若要代表某个人执行操作，通常会使用[OAuth](https://app.pilotiko.com/zh/glossary/oauth)。
2. **它发送一个明确的请求** — 例如：“把圣热罗姆团队3月12日的预约给我。”
3. **软件进行验证并作出响应** — 它以预先约定的格式（通常是JSON）返回数据，或返回一条清晰的错误信息。
4. **客户端使用响应结果** — 它显示这些数据、把它们复制到另一个工具中，或触发某个操作。

## API还是Webhook：该用哪一个？

使用API时，由您在选定的时刻提出问题。要知道某项数据是否变化，就得定期查询软件：GitHub的文档把这称为“轮询”（polling）。[Webhook](https://app.pilotiko.com/zh/glossary/webhook)则正好相反：事件一发生，软件就把数据发送给您 [2]。

| 标准 | API（调用） | Webhook（通知） |
|---|---|---|
| 谁主动发起？ | 发出请求的程序 | 事件发生所在的软件 |
| 交换的时机 | 在查询时 | 事件一发生就交换 |
| 典型用途 | 读取列表、创建档案、查找客户 | 获知一笔付款或一个新的预订 |
| 主要风险 | 无谓地过于频繁查询 | 若不验证来源，可能收到虚假消息 |

## API能节省多少时间？

**示例：魁北克市一家拥有5名技术员的灭虫公司**

假设：每张完成的工单都要手工抄录到会计软件中以开具发票。通过API连接后，工时和所用产品会直接发送过去。

- 每周完成的工单数 : 60
- 每张工单的抄录分钟数 : 4
- 每周录入时间（60 × 4 分钟） : 240分钟，即4小时
- 每月发现的抄录错误（假设） : 6
- **= 通过API连接，每周大约可省去4小时的录入工作，前提是两个软件都提供兼容的API。**

## 使用API时应避免哪些错误？

- 把API密钥粘贴到电子邮件或共享文档中：任何拿到它的人都能代您行事。
- 明明某个集成只需要读取日程表，却授予它完整的权限。
- 搭建[自动化](https://app.pilotiko.com/zh/glossary/process-automation)时，没有考虑API返回错误时会发生什么。
- 以为所有[软件即服务](https://app.pilotiko.com/zh/glossary/saas)都提供API：NIST只是把通过程序接口访问列为一种可能，而不是一项义务 [3]。
- 合同结束后，忘记撤销前任供应商的访问权限。

## Pilotiko的情况如何？

Pilotiko的功能清单中没有提到向客户开放公共API，因此我们在此不作此类声明。如果某项具体的集成对您很重要，请在试用前提出。Pilotiko的[AI智能体](https://app.pilotiko.com/zh/glossary/ai-agent)则是基于应用程序中已有的数据工作，且任何发送都须等待一个人的同意。

## 常见问题

### 使用API必须是程序员吗？

要创建API或直接调用它，确实需要一定的编程知识。但许多自动化工具提供现成的连接器，替您使用API。您只需选择要关联的字段，无需编写代码。

### API安全吗？

这取决于您如何管理访问权限。为每个集成使用不同的密钥，把权限限制在必要的最低程度，并撤销闲置的密钥。切勿通过电子邮件分享密钥。

### API和集成有什么区别？

API是软件提供的入口。集成是两个工具之间的具体连接，会用到一个或多个API。可以有API而没有任何集成。

### “REST API”是什么意思？

这是一种非常普遍的Web API风格：每个资源（一位客户、一次预约）都有一个地址，并使用HTTP协议的方法来读取或修改数据。对中小企业而言，最重要的是文档清晰且保持更新。

### API可能要收费吗？

可能。有些供应商把API保留给更高级的套餐，或限制每天的调用次数。在搭建依赖API的流程之前，请先确认这些限制。

## 资料来源

1. MDN Web Docs, « API (glossaire) », https://developer.mozilla.org/fr/docs/Glossary/API (查阅于 2026-10-15)
2. GitHub Docs, « About webhooks », https://docs.github.com/en/webhooks/about-webhooks (查阅于 2026-10-15)
3. NIST, « SP 800-145, The NIST Definition of Cloud Computing », https://csrc.nist.gov/pubs/sp/800/145/final (查阅于 2026-10-15)
