该技能用于指导使用 Python FastAPI 框架构建 REST API,适用范围包括从零创建新项目、实现接口及生产化实践。
主要能力:提供最小应用示例,导入 FastAPI 后定义根路由并返回 JSON;运行 fastapi dev main.py 后访问 http://127.0.0.1:8000/docs 查看文档。新项目可用 pip install "fastapi[standard]" 安装,或复制 assets/starter-project/ 模板。
核心概念涵盖路径参数(@app.get("/users/{id}") 配合类型标注)、查询参数默认值、Pydantic 请求体模型、Depends 依赖注入与 response_model 输出控制。技能按主题提供参考文件:basics.md(参数、请求体、表单、文件、状态码)、models.md(校验、嵌套模型、序列化)、dependencies.md(依赖模式、类依赖、Annotated)、auth.md(JWT、OAuth2、API Key、RBAC、CORS、安全头)、database.md(SQLAlchemy 同步/异步、Alembic 迁移、仓储模式)、testing.md(TestClient、pytest、覆盖率)、deployment.md(Docker、Gunicorn、Nginx、健康检查)、advanced.md(lifespan、中间件、WebSockets、流式、缓存、GraphQL)。
推荐工作流:定义 Pydantic 结构 → 创建带类型提示的端点 → 注入数据库/认证/配置依赖 → 用 TestClient 与 pytest 测试 → 通过 Docker 与 Gunicorn/Uvicorn 部署。最佳实践包括使用 Annotated 复用依赖类型、区分 Create/Update/Response/InDB 结构、业务逻辑放入服务层、按需使用异步、开发期启用 CORS、添加 /health 端点、用 pydantic-settings 管理配置。限制方面:资料未说明该技能的收费、版本要求、支持平台或性能指标,暂未提供。