APS Data Management API搜索过滤器异常：400错误与空数据问题咨询

问题1：filter[name]/filter[attributes.name]返回400错误的原因及正确过滤方式 #

GET /projects/{project_id}/folders/{folder_id}/search是搜索专用端点，它的过滤规则和普通的文件夹列表端点（如GET /projects/{project_id}/folders/{folder_id}/items）并不完全一致。官方文档中提到的name/attributes.name过滤字段，是针对普通列表端点的，而非这个搜索端点。

这个搜索端点支持的核心过滤参数是filter[searchString]，用于对文件夹/文件名称做模糊匹配。正确的请求示例：

https://developer.api.autodesk.com/data/v1/projects/{PROJECT_ID}/folders/{FOLDER_ID}/search?filter[searchString]=ARC

如果需要仅搜索文件夹（排除文件），可以结合filter[type]=folders缩小范围：

https://developer.api.autodesk.com/data/v1/projects/{PROJECT_ID}/folders/{FOLDER_ID}/search?filter[type]=folders&filter[searchString]=ARC

你遇到的400错误，本质是该搜索端点不支持name或attributes.name作为过滤字段，API识别到无效参数后直接返回错误。

问题2：filter[displayName]返回空数据的原因 #

displayName并非该搜索端点支持的有效过滤字段，虽然语法上没有触发400（API未直接拒绝该参数），但实际上这个参数不会被用于筛选逻辑——如果当前目录下没有默认匹配到的内容，就会返回空数组。

另外，即使某些场景下displayName被识别，它也要求完全精确匹配（区分大小写、空格、特殊字符等），如果你的查询值MyFile和实际文件夹的displayName不完全一致，也会返回空结果。

问题3：服务端问题还是用法有误？ #

是用法有误，核心原因是混淆了不同API端点的过滤规则：

• 普通文件夹列表端点（/items）支持name/attributes.name等字段过滤；
• 搜索专用端点（/search）依赖searchString做模糊搜索，支持的过滤字段远少于列表端点。

建议直接使用filter[searchString]配合filter[type]=folders来实现按名称搜索文件夹的需求。

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