D10 FastAPI + API 设计 — 课件

1. 封面

• D10 FastAPI + API 设计｜第 2 周

2. 目录

• FastAPI 为什么 / 最小应用 / 参数与校验 / 鉴权 / REST 规范 / 错误处理

3. FastAPI 为什么

• 幻灯1：自动 Swagger / 类型即校验 / 异步 / 性能
• 幻灯2：公司例子 —— api.akria.net（core-api-v2）

4. 最小应用（现场演示）

• 幻灯1：5 行代码 + uvicorn
• 幻灯2：/docs 自动文档

5. 参数与校验

• 幻灯1：路径参数 / 查询参数 / 请求体模型
• 幻灯2：pydantic BaseModel
• 幻灯3：类型标注即校验（传错自动 422）

6. 鉴权

• 幻灯1：Depends + Header 做 key 校验
• 幻灯2：Bearer vs x-api-key（回顾 D3）
• 幻灯3：401 认证失败 vs 403 授权不足

7. REST 设计规范

• 幻灯1：资源名词 / 方法表达动作
• 幻灯2：状态码语义 / 幂等
• 幻灯3：反例最有说服力

8. 错误处理与日志

• 幻灯1：对外干净结构，细节进日志
• 幻灯2：结构化错误 {"detail": "..."}

9. 常见误区

• 幻灯1：URL 动词 / 全 200 / 鉴权散落各处

10. 作业布置

• 幻灯1：写 mini CRUD API（users 资源）+ 鉴权（详见作业.md）

11. 结尾

• 预告 D11：Postgres/SQL —— 给 API 配上数据库