Autodesk Forge API咨询：Fusion 360团队中心文件查询与最近访问文件获取

1. 跨Fusion 360团队中心查询并筛选文件 #

• 无需递归遍历文件夹，直接使用Forge Data Management的搜索接口（POST /data/v1/search）实现全局查询。
• 该接口支持跨项目、跨文件夹的团队级搜索，通过filter参数可按文件名、文件类型、创建者等条件精准筛选。例如：
  • 筛选文件名包含指定关键词：filter=attributes.displayName contains '部件模型'
  • 组合筛选（如文件名+文件类型）：filter=attributes.displayName contains '部件' AND attributes.fileExtension='f3d'
• 接口支持分页机制，通过limit和offset参数控制每次返回的数据量，避免单次请求负载过高，同时大幅减少API调用次数。

2. 获取最近访问/修改的N个文件列表 #

• 同样借助上述搜索接口，通过sort参数按时间字段排序，配合limit=N直接获取前N条结果：
  • 按最近访问时间排序：sort=-attributes.lastAccessedTime（负号表示降序，优先返回最新访问的文件）
  • 按最近修改/保存时间排序：sort=-attributes.lastModifiedTime
  • 按创建时间排序：sort=-attributes.createTime
• 若要精准筛选某一类操作的文件，可结合filter限定时间范围，比如筛选近7天内访问的文件：filter=attributes.lastAccessedTime >= '2024-01-01T00:00:00Z'

关键注意事项 #

• 调用接口需确保申请的OAuth权限包含data:read范围，否则无法获取团队内的文件数据。
• 搜索接口的全局查询能力完全替代了递归遍历文件夹的方式，从根源上减少了API调用次数，效率提升明显。

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