关于Autodesk BuildingConnected GET Opportunities API updatedAt参数更新规则的问询

关键逻辑说明 #

Autodesk BuildingConnected的顶层updatedAt字段不会随Opportunity所有内容的变更同步更新：

• 只有当Opportunity的顶层核心属性（如基本信息、名称、主状态等非嵌套字段）发生变更时，顶层updatedAt才会更新。
• 嵌套对象（比如outcome）的属性变更，只会更新该嵌套对象自身的updatedAt字段，不会触发顶层updatedAt的变化。

针对你的问题场景 #

你遇到的情况正是这个逻辑导致的：当outcome.state在2025年1月7日变更为"Won"时，仅outcome.updatedAt会更新为对应时间，而顶层updatedAt仍保留最后一次顶层属性变更的时间（2024年12月1日）。因此用顶层updatedAt作为查询条件时，这条记录无法被拉取到。

解决办法 #

• 若要捕获outcome相关的变更，不要仅依赖顶层updatedAt查询参数，尝试使用outcome.updatedAt的过滤条件（例如outcome.updatedAt[gte]=2025-01-01，具体格式需遵循API的过滤规则）。
• 核对API文档中查询参数的说明，确认是否支持嵌套字段过滤，或是否有其他参数可覆盖这类嵌套对象变更的场景。

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