API(应用程序编程接口)是软件向另一个系统请求数据或操作的一种约定方式。API 会说明调用方可以请求什么、需要提供哪些信息,以及可以收到什么响应。双方按照同一套接口沟通,不必了解对方内部程序是怎样编写的。
API 可以存在于操作系统和软件库中,也可以连接网络服务。Web API 通常使用 HTTP,但 API 的含义更广。MDN 的 API 术语说明介绍通用概念;OpenAPI 规范定义了描述 HTTP API 的一种标准方式。
API 如何工作
调用方按照 API 约定发送请求。提供服务的系统会检查请求和调用方权限,执行获准的操作,再返回结果或错误信息。约定可以列出可用操作、必填字段、数据格式、身份验证方式和错误响应。根据设计,API 可以读取数据、修改记录,也可以同时支持两者。
HTTP API 通常通过端点标识数据或操作,请求和响应可以使用 JSON 等结构化格式。清晰的文档能帮助开发人员了解接口,再把它接入另一个应用。
企业应用示例
以下示例仅用于说明:网店在确认订单前需要检查商品库存。它向库存系统发送商品和数量,库存系统返回是否有货。如果调用方具备相应权限,业务流程也允许,系统还可以另外提交预留库存的操作。网店根据响应继续处理,或把异常交给员工复核。
API、REST 和 JSON
API 是软件交互时使用的接口;REST 是设计部分网络 API 时采用的一种架构风格;JSON 是请求或响应可能使用的一种数据格式。REST API 可以使用 JSON,但 REST 和 JSON 都不是 API 的必要条件。
API 不会代替背后的业务规则。团队仍需确定每条记录由哪个系统负责、谁可以发起哪些操作,以及数据缺失或请求失败时如何处理。
API 本身不能解决什么?
接通系统只是集成工作的一部分。团队还要统一数据含义,限制用户可执行的操作,并安排错误处理、重试、重复请求和 API 变更的跟进责任。这些安排会影响系统能否适应日常运营并持续维护。
如果不同系统需要在业务流程中交换数据,可以了解 technine.io 的系统集成与流程自动化服务,进一步梳理集成范围。
常见问题
API 就是网站吗?
不是。网站提供供人操作的界面,API 提供供软件调用的接口。网站可以在后台使用 API,也可以向其他应用提供 API。
所有 API 都使用 REST 或 JSON 吗?
不是。API 可以采用不同的设计和数据格式。REST 和 JSON 在 Web 开发中很常见,但 API 不一定要使用它们。
接通两个 API 就完成系统集成了吗?
不一定。集成还需要明确数据定义、权限、异常处理和测试安排,并确定谁负责后续变更和支持。
延伸阅读:阅读什么是 MCP,了解 AI 应用如何连接工具和上下文;也可以查看什么是 Agent Skills。
主要资料来源:MDN:API 术语说明 · OpenAPI 规范 · Roy Fielding 的 REST 论文
