API / 应用程序接口

先用一句话抓住它

API 是软件之间按照约定互相调用功能、读取数据或提交操作的接口。

生活里的例子很多。你在外卖 App 下单，不需要知道餐厅厨房怎么做菜；App 只需要通过接口把订单发出去，再接收状态。你在网站上使用第三方登录、地图、支付、短信通知，也都离不开 API。

API 解决的问题

现代软件很少是孤岛。一个网站可能要调用支付系统、地图服务、短信服务、登录服务、库存系统和 AI 模型服务。如果没有 API，每个系统都要直接了解对方内部结构，维护会非常困难。

flowchart LR
    App["应用 A"] --> Request["API 请求"]
    Request --> Service["应用 B / 服务"]
    Service --> Response["API 响应"]
    Response --> App

API 把复杂系统包装成可调用的入口。调用方发出请求，服务方返回响应。请求里会包含参数，例如用户 ID、页码、搜索词或订单信息；响应里会包含结果、状态或错误说明。为了防止随便访问，很多 API 还需要密钥、登录凭证或其他鉴权方式。

常见 API 形态

最常见的是 Web API，也就是通过网络访问的接口。REST API 是其中非常常见的一种风格，通常用 URL 表示资源，用 HTTP 方法表示读取、创建、更新或删除。GraphQL 则允许调用方声明自己需要哪些数据，避免一次拿太多或太少。

SDK 和 API 关系也很近。SDK 通常把 API 调用封装成某种编程语言里的工具包，让开发者不必手写底层请求。对使用者来说，SDK 更像“顺手的工具”，API 更像背后的服务入口。

和 AI 的关系

AI 应用经常需要调用 API。聊天助手查天气、创建日历、查询订单、读取 CRM、发送消息、生成图片、生成向量，都可能通过 API 完成。对 Agent 来说，API 是从“会说话”走向“能办事”的关键通道之一。

OpenAI、地图、支付、短信、数据库和企业系统通常都会通过 API 提供能力。MCP 这类协议背后，也常常会把已有 API 包装成更适合 AI 应用调用的形式。

容易误解的地方

API 不是网页界面。网页界面主要给人点按钮，API 主要给软件调用。有 API 也不代表可以随便访问，大多数 API 都有权限、配额和计费规则。

另一个误区是把 API 当成数据库本身。API 是访问功能或数据的入口，背后可能是数据库、业务系统、第三方服务或模型服务。调用成功也不代表业务成功，还要看返回内容、状态码和错误处理。

怎么判断它该不该用

使用 API 时，要关注权限、速率限制、错误处理、数据格式和安全。密钥不能泄露，敏感数据要加保护，失败请求要能重试或给出明确提示。

如果 API 会执行写入、删除、付款或发送消息等动作，就更需要确认机制和日志记录。

资料来源

• API - Wikipedia
• MDN: Introduction to web APIs
• Postman: What is an API?
• REST API Tutorial
• Cloudflare: What is an API?