🌐 HTTP 与 JSON
调用大模型 API、抓数据、对接第三方服务,第一步都是同一件事:把请求发出去,把 JSON 收回来。 这门课不背协议,只讲清楚一次请求在路上发生了什么,以及怎么用代码稳定地跑通它。
🗺️ 学习路线图
| 阶段 | 章节 | 内容 |
|---|---|---|
| 🔍 看懂 | 第 1 ~ 3 章 | 请求的完整旅程、方法与状态码、报文结构与 JSON |
| 🚀 会发 | 第 4 ~ 5 章 | 用 Python 发出请求、鉴权与密钥管理 |
| 🌊 会处理 | 第 6 章 | 流式响应与 SSE,接住大模型一个字一个字吐出来的结果 |
📚 章节导航
| 章节 | 难度 · 阅读 | 一句话概要 |
|---|---|---|
| 1 · 请求的完整旅程 | ⭐ 15 min | URL 解剖、DNS、TCP、TLS、请求响应模型 |
| 2 · 方法与状态码 | ⭐⭐ 20 min | GET 和 POST 差在哪、幂等、状态码,用 curl 亲手验一次 |
| 3 · 报文与 JSON | ⭐⭐ 20 min | 请求行、请求头、Content-Type、JSON 的类型与序列化 |
| 4 · Python 发请求 | ⭐⭐ 20 min | requests / httpx、超时、重试、连接复用 |
| 5 · 鉴权与密钥管理 | ⭐⭐ 18 min | Bearer Token、.env、401 与 403 的区别、限流 |
| 6 · 流式响应 SSE | ⭐⭐⭐ 22 min | 为什么大模型要流式、SSE 报文长什么样、怎么逐行读 |
🎯 适合人群
| 人群 | 推荐起点 | 阅读建议 |
|---|---|---|
| 没发过 HTTP 请求 | 第 1 章 | 按顺序读,第 4 章一定自己跑通一次真实请求 |
只会 curl 复制粘贴 | 第 3 章 | 重点看状态码和 JSON 两章,能少踩一半坑 |
| 要接大模型 API | 第 1 章 | 第 5、6 章必读:密钥管理和流式输出是刚需 |
| 写爬虫 / 对接第三方 | 第 2 章 | 重点第 2、4 章:幂等、重试、限流 |
📂 目录结构
docs/notes/http-json/ # 课程正文(线上路径 /notes/http-json/)
├── README.md # 本页:学习路线与章节导航
└── chapters/ # 6 个章节
├── 01-request-journey.md
├── 02-methods-status.md
├── 03-message-json.md
├── 04-python-requests.md
├── 05-auth-secrets.md
└── 06-sse-streaming.md
docs/public/notes/http-json/diagrams/ # 手绘 SVG 结构图(随构建发布)🧭 怎么读这门课
- 第 4 章需要一个能跑的 Python 环境;
requests装一下就行,不必读完整本 Python 教程。 - 文中的请求示例都可以直接复制到终端或 Python 里执行,改掉域名就能用。
- 图比较多,遇到看不懂的流程可以先看图,再回头读文字。
- 每一步都问自己三个问题:发给谁、带了什么、回来的是什么。
💡 一句话原则:HTTP 就是"一问一答",JSON 就是"问答双方约定的写法"。所有复杂的东西,都是这两句话的变体。