AI 小白学 API 完全指南
AI 小白学 API 完全指南
学习日期：2026-06-16
一、什么是 API？
API（Application Programming Interface，应用程序接口）
用最简单的说法：API 是程序与程序之间对话的窗口。
你用浏览器打开笔记中心，浏览器和服务器之间就在通过 API 通信：
浏览器（你） Flask（服务器）
│ │
│ GET / （我要看首页） │
│ ──────────────────────────→ │
│ │
│ ←────── HTML 页面 ──────────── │
二、餐厅比喻
| 概念 | 餐厅比喻 | 代码中的例子 |
|---|---|---|
| GUI（图形界面） | 看菜单图片点菜 | 浏览器打开页面 |
| CLI / Bash | 直接对老板喊话 | cd、ls、git 命令 |
| API | 服务员/传菜窗口 | 浏览器←→服务器的通信规则 |
API 就是那个传菜窗口，规定了：
- ✅ 能点哪些菜（有哪些接口）
- ✅ 怎么下单（GET 还是 POST）
- ✅ 菜怎么端出来（返回 JSON 还是 HTML）
三、API 怎么交互
HTTP 方法（菜的"做法"）
| 方法 | 含义 | 笔记中心的例子 |
|---|---|---|
| GET | 获取数据（看） | 看首页、看笔记、看金价 |
| POST | 提交数据（写） | 新建笔记、保存笔记 |
| PUT | 更新数据（改） | 修改笔记内容 |
| DELETE | 删除数据（删） | 删除笔记 |
状态码（服务员告诉你的"结果"）
| 状态码 | 含义 | 像服务员说… |
|---|---|---|
| 200 | ✅ 成功 | "好的，这是你的菜" |
| 404 | ❌ 没找到 | "不好意思，这道菜没有" |
| 500 | 💥 服务器炸了 | "厨房着火了！" |
数据格式（菜的"摆盘方式"）
最常见的是 JSON——就是你刚学的那个：
JSON
{
"updated_at": "2026-06-16 15:35",
"today": {
"shfe_price": 938.4,
"shuibei_price": 1078.1
},
"brands": {
"周大福": 1307,
"周生生": 1305
}
}
四、用 curl 调 API（亲手试试）
Bash
# ① 获取首页
curl http://127.0.0.1:5000/
# ② 获取金价页面
curl http://127.0.0.1:5000/gold
# ③ 只看返回的 HTTP 状态码
curl -s -o /dev/null -w "%{http_code}" http://127.0.0.1:5000/
# 返回 200 → 表示成功！
五、笔记中心里的 API
这个 Flask 应用的 routes.py 定义了所有这些"传菜窗口"：
| 接口路径 | 方法 | 作用 |
|---|---|---|
/ |
GET | 获取首页笔记列表 |
/gold |
GET | 获取黄金价格页面 |
/note/save |
POST | 新建/保存笔记 |
/note/<id>/delete |
POST | 删除笔记 |
/preview |
POST | 预览 Markdown 渲染效果 |
六、世界就是个 API
你现在每天都在用 API：
| 场景 | 背后的 API |
|---|---|
| 📱 刷朋友圈 | 微信App ←→ 微信服务器 |
| 🌤️ 看天气 | 天气App ←→ 气象局API |
| 💳 支付宝付款 | 支付宝 ←→ 银行API |
| 🤖 和我聊天 | Claude ←→ Anthropic API |
七、一句话总结
API 是程序之间的"传菜窗口"——规定了你要什么，怎么给你，给你什么格式。
你点外卖用 App，App 调餐厅的 API 下单，餐厅做完了通过 API 通知 App 来取——全是 API 🌐