编辑 - 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** 🌐

预览

编辑内容后实时预览...