No.15核心核对于 2026-09-261 条来源

APIApplication Programming Interface

一句话

API 是一个程序对外提供的调用约定，写明怎么发请求、要带什么、会返回什么。

大白话

API 像餐厅的外卖菜单：能点哪些菜、每道菜要选什么口味、多少钱、会送来什么，都写得清清楚楚，你照着下单就行，不用走进后厨。

比喻的边界

菜单上有的菜一般都能点，API 却可能要求先登录或带密钥、限制调用次数，还会随版本变化；文档和实际不一致时，以真实请求的结果为准去排查。

拿去就能用

开始做

我要给商品列表做一个接口，前端需要。先帮我写出接口地址、请求方式和返回的样子，我确认后再写代码，写完告诉我怎么在浏览器或终端里请求一次确认返回正确。

还差：要返回的字段，发给 AI 前记得换掉

出错了

我调用天气接口一直返回 “invalid api key”，但我确认复制的是完整的 key。我怀疑是请求头的名字或位置写错了，先帮我对照接口文档检查我的请求写法。贴出来的代码里 key 已换成 ***。

想做深

我的商品接口现在一次返回全部商品，以后可能有几千条。帮我给列表接口加上分页，先说明参数怎么设计、返回里要加哪些信息、前端要跟着改什么，确认后再写。

别这样说

这个接口没数据，你帮我看看。

这样说

商品列表页调 /api/products 返回空数组，但数据库里有 3 条商品。帮我先对比请求参数和接口要求，找到差异再改，改完告诉我怎么验证。

差别：补上了对象、现象、证据和验证方式。

容易误解：

误解API 就是一个网址。

其实是Web API 通常通过网址访问，但它包括请求方式、参数、认证和返回格式这一整套约定；代码库、操作系统也提供 API，不一定要联网。

展开专业理解

API 是软件对外开放能力的约定。Web 开发里常说的 API 多是通过 HTTP 访问的接口，由地址、方法、参数、请求头（常含认证信息）和响应格式组成，数据多用 JSON。浏览器本身也提供大量 API，比如本地存储、定位，供页面里的 JavaScript 调用。