📖 REST API 是什么？

⚡ 一句话秒懂

REST API 是餐厅的点菜规矩：按固定格式报菜名（地址），厨房（服务器）按规矩给你端菜（数据）。

📖 举个故事

小张去快餐店，柜台上方挂着菜单：'3 号是汉堡，5 号是可乐'。他喊'来个 3 号'，窗口递出汉堡；他想改订单，走改单窗口；想退单，走退款窗口。每个窗口各管一件事，规矩统一，谁来了都会点。程序之间也一样：A 程序想要用户数据，就按约定访问 /users/123 这个'窗口'，服务器把数据递出来；想查订单就访问 /orders。规矩统一了，任何程序都会'点菜'，不用打电话跟厨房吵架。

💡 类比理解

暂未补充。

🧩 真实例子

暂未补充。

🛠️ 怎么实际使用

你在用 AI 做应用时，几乎一定会碰 REST API。比如接 OpenAI 或 DeepSeek 的接口，就是把问题发到指定网址、拿回回答。实操要点：一是找到 API 文档里的'网址+方法'（GET 是取数据，POST 是提交数据）；二是准备好密钥；三是看返回的 JSON。让 AI 帮你写调用代码时，直接把 API 文档贴给它，它生成的代码准确率会高很多。

📚 进阶原理

REST 是一种 API 设计风格：用 URL 定位资源（/users/123），用 HTTP 方法表达动作（GET 读、POST 增、PUT/PATCH 改、DELETE 删），无状态——每个请求自带全部信息（通常用 Authorization 头带 token），服务器不记上下文。响应一般为 JSON，配合状态码（200 成功、401 未授权、429 限流）判断结果。调用大模型 API 时典型流程是 POST 一段 JSON 到 /chat/completions，处理流式响应（SSE）并在 429/500 时做指数退避重试。

继续学习相关术语