关于Clio API基于嵌套资源过滤数据的URL语法问询

核心语法说明 #

Clio API针对嵌套资源的过滤，通常采用点语法引用嵌套字段，配合过滤参数实现。以你需要筛选关联未结事务的任务为例：

• 假设任务资源的基础端点为/tasks
• 事务（Matter）是任务的关联资源，事务状态字段为status，未结状态对应的枚举值一般为Open（具体值需以Clio实际定义为准）

对应的URL构造示例：

/tasks?filter[matter.status]=Open

关键注意事项 #

• 必须明确嵌套字段的层级：任务关联的事务是matter，事务的状态是status，因此用matter.status定位嵌套字段
• 过滤参数格式为filter[嵌套字段路径]=目标值，方括号是语法要求，不可省略
• 若未结状态的枚举值不是Open，可先通过/matters端点查询事务的合法状态取值

文档缺失的补充说明 #

Clio官方文档偶尔会遗漏嵌套过滤的细节，这类点语法属于REST API过滤的通用扩展逻辑，你可以用类似方式测试其他嵌套场景，比如筛选归属特定客户的任务：

/tasks?filter[matter.client.id]=12345

内容的提问来源于stack exchange，提问作者gcb_fd