使用folders/:folderid/contents接口获取ACC文件夹内容失败求助

问题回顾 #

通过Postman操作ACC API获取「Project Files」文件夹内容时，完成以下步骤后报错：

1. 调用projects/v1/hubs获取hubId；
2. 调用/hubs/:hubid/projects获取projectId；
3. 调用hubs/hubid/projects/project_id/topFolders提取「Project Files」的folderId（格式为urn:adsk.wipprod:fs.folder:co.bEd9KCbyQAWbhE938Cy48Q）；
4. 调用projects/project_id/folders/folderId/contents时收到错误："developerMessage": "The requested resource does not exist."

修复方案 #

• 修正API端点路径
  正确的文件夹内容查询端点应包含data/v1前缀，格式为：

  GET /data/v1/projects/{project_id}/folders/{folder_id}/contents
  

  当前使用的路径缺少该前缀，导致API无法定位资源。

• 转换folderId格式
  从topFolders接口返回的是完整URN格式的folderId，但调用contents接口时只需使用URN的最后一段（即co.bEd9KCbyQAWbhE938Cy48Q），无需保留urn:adsk.wipprod:fs.folder:前缀。

• 验证权限与资源关联

  • 确认访问令牌拥有该项目的data:read权限，可通过解码JWT令牌检查权限范围；
  • 核对projectId与folderId是否属于同一个hub，避免跨hub的资源关联错误。

• 校验参数准确性
  检查projectId和截取后的folderId是否完全匹配，注意大小写、特殊字符，避免复制时的遗漏或修改错误。

验证步骤 #

1. 使用修正后的端点和截取后的folderId重新发起请求；
2. 若仍报错，先调用GET /data/v1/projects/{project_id}/folders/{folder_id}验证该文件夹是否存在，确认资源有效性。

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