API
中级通用
API（应用程序编程接口）是软件向其他软件开放功能或数据的一套调用约定。它让你不用了解对方内部怎么实现，也能按约定发起请求、取得结果；比如网站通过天气服务的 API 获取预报。
你可能会说：「我想让网站显示用户的订单，不想把数据库连接和查询逻辑放在网页里，该怎么让前后端配合？」
动手看看给出行网站加上天气查询
1
网站想查杭州的天气。示例 API 约定请求必须带城市参数，但网站第一次只发了查询请求，漏填了城市。
要点调用一个 API 时要说清什么？
- 1
先确定谁提供能力谁来调用
做订单页时，后端可以提供查询订单的 API，前端负责调用并显示结果。这样分工的好处是，前端不必知道订单存在哪张表里，后端也能统一处理数据和权限。
- 2
约定输入输出和失败情况
你和 AI Agent 讨论接口时，光说“获取订单”还不够。把需要的订单编号、返回的字段，以及找不到订单时的结果说清楚，双方才能按同一份约定开发和检查。
- 3
调用方式取决于接口类型
网站常通过网络请求调用 API，但 API 不只存在于网络上；代码库也可以提供函数供其他代码调用。所以看到“接 API”，你可以先问清楚：是调用外部服务、自己的后端，还是项目里的代码接口？
容易混淆的地方
API 是软件之间约定好的能力入口，不等于数据库：数据库负责保存和查询数据，API 可以在它前面控制谁能查、能查什么。API 也不等于 HTTP；HTTP 是网络通信方式，许多 Web API 用它传递请求和结果，但代码库提供的函数接口也属于 API。
什么时候用
适合用
- 网站要展示登录用户的订单，由前端调用后端 API 获取经过权限检查的数据。
- AI 工具要调用模型服务生成摘要，通过服务商提供的 API 发送内容并接收结果。
- 手机 App 要展示物流状态，通过物流服务的 API 获取更新，而不是人工逐条录入。
不适合用
- 静态展示页只有几段固定文案，没有动态数据或外部能力，直接写进页面更简单。
- 设置项只在当前浏览器使用，也不用跨设备同步，可以先用浏览器存储保存。
- 一次性整理少量历史记录，之后不再自动同步，用文件导入比搭建调用接口省事。
练一练选一个答案，看看解释
你在做订单详情页：前端需要按订单编号取数据，且用户只能看自己的订单。你会怎样让 AI Agent 实现？
让 AI 帮你做复制给 AI Agent 直接用
请为订单详情页设计并实现前后端之间的查询 API：前端传入订单编号，后端只返回当前登录用户有权查看的订单字段。先列出输入、成功与失败时的输出，再实现调用和错误提示；不要让前端直接连接数据库。