🧒 极简版
你去餐厅吃饭。你不用自己进厨房做菜——你告诉服务员"来份宫保鸡丁",服务员把你的需求传给厨房,厨房做好了,服务员端给你。
API 就是这个服务员。它是你(App)和服务器(厨房)之间的传话人。你只需要知道"菜单上有什么"就行,不用管厨房是怎么做菜的。
🧑 场景版
你在美团点外卖,用支付宝付款。
发生了什么?美团不可能自己做一个支付系统——它调用了支付宝的 API。具体过程:
1. 美团向支付宝 API 发送一个请求(Request):"用户要付 35 元"
2. 支付宝处理完后返回(Response):"支付成功,订单号 xxx"
3. 美团收到结果,显示"已付款"
整个过程美团不需要知道支付宝内部怎么运作——它只需要按照 API 文档"点菜"就行。
🎓 精准版
API 是一组预定义的协议和接口,允许不同软件系统之间进行通信。现代 Web API 通常基于 HTTP/REST 架构:
· 端点(Endpoint):URL 地址,如 `GET /api/weather?city=beijing`
· HTTP 方法:GET(读)、POST(写)、PUT(改)、DELETE(删)
· 请求体(Request Body):发送的数据(通常 JSON 格式)
· 响应体(Response):返回的数据 + 状态码(200=成功, 404=没找到, 500=服务器错误)
· 认证(Auth):API Key / OAuth / JWT 验证调用者身份