Forge Fetchallproperties需多次尝试生效及ModelDerivative API属性获取咨询

原因 #

• 属性生成是异步后台任务：新导出的模型完成转换后，属性提取并不是同步完成的，而是后台异步执行的任务。此时发起首次属性请求，后台任务可能还未完成，自然返回空结果。forceget=true仅用于跳过缓存获取最新数据，无法强制后台提前完成属性生成任务。
• 任务队列调度延迟：新模型的属性生成任务可能排在系统任务队列中，首次请求时任务还未被调度执行。多次请求相当于多次触发系统检查任务状态，等任务被调度完成后，后续请求就能获取到属性数据。

解决办法 #

• 轮询等待结果：首次请求返回空时，设置2-5秒的间隔重复发起请求，直到获取到非空结果或达到预设的最大重试次数。注意不要过于频繁请求，避免触发API限流机制。
• 通过Webhook监听完成事件：订阅Autodesk的Webhook，监听模型衍生完成的事件。当后台属性生成任务完成后，系统会主动推送通知，此时再发起属性请求即可确保获取到数据。
• 先检查模型衍生状态：在请求属性前，调用GET /modelderivative/v2/designdata/{urn}/manifest接口，检查模型的衍生状态。确认对应视图（2D/3D）的status为success，且属性相关的衍生输出已完成后，再发起属性请求。

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