过滤、排序与搜索

过滤、排序和搜索是查询功能，允许 API 消费者检索他们确切需要的数据，而不是获取所有数据并在客户端进行处理。过滤通过字段值缩小结果（?status=active），排序对它们进行排序（?sort=created_at&order=desc），而搜索允许跨字段进行自由文本或模糊匹配。使用可预测的查询参数名称并清楚地记录支持的组合是 API 用户体验的重要组成部分。