Autodesk Webhook API的dm.folder.deleted事件无法触发问题咨询

首先明确官方定义的dm.folder.deleted触发逻辑：仅当你注册Webhook时指定的目标文件夹本身被彻底删除时才会触发，子文件夹的删除操作不会触发该事件（这也是你测试dm.folder.modified能正常触发的原因——子文件夹变更属于父文件夹的修改事件）。

针对你遇到的触发失败问题，可从以下几个方向排查：

1. 确认文件夹删除的操作类型 #

在Autodesk Construction Cloud中，常规的“删除”操作只是将文件夹移至回收站，而非彻底删除。dm.folder.deleted事件仅在回收站中的文件夹被彻底删除时才会触发。请按以下步骤操作：

• 将目标文件夹移至回收站
• 进入回收站，找到该文件夹并执行彻底删除操作
• 等待5-10分钟（Webhook可能存在延迟）后检查回调是否收到事件

2. 验证OAuth令牌权限 #

注册Webhook时的令牌需要具备data:write权限，否则无法触发涉及写入操作的事件。你可以通过调用权限校验接口确认令牌权限范围，或者重新生成包含data:write权限的令牌后重新注册Webhook。

3. 检查Webhook的状态与配置 #

• 调用GET /webhooks/v1/hooks接口，确认dm.folder.deleted对应的Webhook状态为active，且scope中的文件夹URN完全正确
• 确认回调URL在事件触发时处于可用状态（比如ngrok会话未过期、公网可访问），虽然dm.folder.modified能触发，但删除操作发生时可能刚好遇到服务中断，建议测试时保持ngrok持续运行

4. 启用Webhook日志排查 #

如果以上步骤都无问题，可在Autodesk开发者控制台开启Webhook的日志功能，查看事件是否被系统生成，以及回调失败的具体原因（比如回调URL返回了非2xx状态码、网络超时等）。

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