过滤、排序与搜索

过滤、排序和搜索是一类查询能力，能让 API 消费方精确获取所需数据，而不必拉取全部内容再在客户端处理。过滤按字段值收窄结果（?status=active），排序对结果进行排列（?sort=created\_at&order=desc），搜索则支持跨字段的自由文本或模糊匹配。使用可预测的查询参数名来设计这些功能，并清晰地文档化所支持的组合方式，是提升 API 可用性的重要一环。