用途:该技能面向使用 FastAPI 与 Pydantic V2 构建高性能异步 Python API 的场景,适用于创建 REST 端点、定义 Pydantic 校验模型、实现异步数据库操作、JWT 认证鉴权、WebSocket 端点以及 API 性能优化。
主要能力:提供从需求分析、Schema 设计、异步端点实现、安全加固到测试的完整工作流,每一步后设检查点,确认模型校验、HTTP 状态码与 /docs 文档符合预期。附带参考指南:Pydantic V2、异步 SQLAlchemy、端点路由、认证、异步测试、从 Django/DRF 迁移,分别在相应场景加载。
使用方式:用类型提示与 Pydantic V2 语法(field_validator、model_validator、model_config)定义模型,用 Annotated 模式做依赖注入,所有 I/O 使用 async/await,用 X | None 代替 Optional[X],返回正确 HTTP 状态码。测试使用 pytest 与 httpx 编写异步测试,每组端点完成后运行 pytest,并在 /docs 核对 OpenAPI 文档。实现时输出 Schema 文件、端点文件、涉及数据库时的 CRUD 操作及关键决策说明。
限制:不得使用同步数据库操作,不得跳过 Pydantic 校验,不得明文存储密码或在响应中暴露敏感数据,不得使用 Pydantic V1 语法(@validator、class Config),不得混用同步与异步代码,不得硬编码配置值。相关环境配置与完整安装细节暂未提供。