用途:为 FastAPI 应用提供 REST API 设计模式与实现模板,覆盖 CRUD、分页、过滤、请求/响应模型、错误处理与路由组织,帮助开发者按现代最佳实践搭建接口。
主要能力:提供 CRUD 端点模板(POST/GET/PUT/PATCH/DELETE),支持偏移、游标、页码三种分页策略,以及分类、价格区间、关键词等过滤与排序;用 Pydantic 定义创建、更新、数据库、返回等分层模型,并用泛型 PaginatedResponse 返回分页元数据;统一 HTTPException 与自定义异常处理器、校验错误定制;通过依赖注入复用鉴权、数据库会话、分页参数;用 APIRouter 模块化组织并支持版本前缀;增强 OpenAPI 文档。附带聊天消息、用户管理、AI 会话记忆/上下文三个完整示例。
使用方式:复制模板到项目路由目录后按自己的模型与数据库操作改写,例如 cp ./skills/fastapi-api-patterns/templates/crud_endpoint.py app/routers/items.py;分页模板复制到 app/utils/pagination.py,错误处理模板复制到 app/utils/errors.py;可运行 bash ./skills/fastapi-api-patterns/scripts/validate-endpoints.sh app/routers/items.py 校验端点结构,或运行 generate-openapi-docs.sh 生成增强文档。
适用场景:需要快速构建规范 RESTful 接口的 FastAPI 项目,包括聊天消息、用户管理及 AI 应用记忆/上下文接口。
限制:要求 FastAPI 0.100+、Pydantic 2.0+、Python 3.10+;SQLAlchemy、JWT、密码哈希、文件上传等为可选依赖,资料未说明具体安装步骤与版本细节;涉及收费、平台或效果的信息暂未提供。