用途
API Filtering & Sorting 用于为 API 构建灵活、高效的过滤与排序系统，能够处理复杂查询，并兼顾校验、安全与性能优化。它适合在构建搜索与筛选界面、实现高级查询能力、创建灵活的数据检索端点、优化查询性能、校验用户查询输入以及支持复杂过滤逻辑时使用。
主要能力
该技能围绕过滤与排序的完整链路展开，资料中列出的参考指南包括：
- 查询参数过滤（Query Parameter Filtering）
- 高级过滤器解析器（Advanced Filter Parser）
- 过滤器构建器模式（Filter Builder Pattern）
- Python 过滤（SQLAlchemy）
- Elasticsearch 过滤
- 查询校验（Query Validation）
这些指南覆盖从参数解析、过滤器构建到具体技术栈实现与输入校验的各个环节。
使用方式
资料提供了一个 Node.js 的最小工作示例：在 /api/products 路由中解析过滤参数，通过 allowedFilters 白名单（category、minPrice、maxPrice、inStock、rating）收集允许的过滤条件，并据此构建 MongoDB 查询。示例中展示了按 category 构建 mongoQuery.category 的写法，完整实现需参考 references/ 目录下的参考指南。
适用场景
- 构建搜索和筛选界面
- 实现高级查询能力
- 创建灵活的数据检索端点
- 优化查询性能
- 校验用户查询输入
- 支持复杂过滤逻辑
最佳实践
资料给出的推荐做法（✅ DO）包括：白名单允许的过滤字段；校验所有输入参数；为用于过滤的字段建立索引；支持常用操作符；提供分面导航；缓存过滤选项；限制过滤复杂度；记录过滤语法；使用数据库原生操作符；借助索引优化查询。
应避免的做法（❌ DON'T）包括：允许任意字段过滤；支持无限操作符；忽视 SQL 注入风险；创建复杂的过滤逻辑；暴露内部字段名；在未索引字段上过滤；允许深层嵌套过滤；跳过输入校验；用 OR 组合所有过滤条件；忽视性能影响。
限制
资料未提供具体的收费、价格、平台支持范围或效果数据，这些信息暂未提供。完整实现细节需查阅其 references/ 目录下的参考指南。