用途:为使用 FastAPI 构建 Python API 提供系统化指导,涵盖 REST API、自动校验、依赖注入、安全认证、中间件、CORS、数据库、测试等主题,并附按主题划分的参考文档索引(如 first-steps、path-parameters、validation、dependencies、security、sql-databases、testing 等)。
主要能力:类型安全参数(Annotated 配合 Path/Query)、Pydantic 模型与请求体校验、response_model 输出过滤、依赖注入、OAuth2/JWT 认证、表单与文件上传、错误处理、后台任务、WebSocket、模板、环境变量设置、生命周期事件与 OpenAPI 高级配置。自动生成 Swagger UI(/docs)、ReDoc(/redoc)与 OpenAPI(/openapi.json)。
使用方式:需 Python 3.10+,安装 pip install "fastapi[standard]"(含 uvicorn)或 pip install fastapi(最小安装),表单/文件需 python-multipart。运行命令为 fastapi dev main.py。
版本要点:0.134.0 支持流式 JSON Lines 与二进制数据;0.135.0 支持 SSE(EventSourceResponse);0.136.1 更新 Pydantic v2 代码并升级 Starlette 至 1.0.0;0.136.2–0.136.3 加强 SSE 事件字段校验,且默认 convert_underscores=True 时不再接受下划线命名的请求头。
限制与建议:避免返回原始数据库模型、明文存储密码、在同一端点混用 Body 与 Form/File、在异步端点使用同步阻塞 I/O、跳过 HTTPException。具体收费、平台与效果资料暂未提供。