如何通过Forge获取Autodesk Construction Cloud中默认属性Description的值

1. 调用正确的核心元数据接口 #

默认属性"Description"属于文档的核心元数据，并非自定义属性或成本属性范畴，你之前调用的接口都不对路，应该用文档详情接口：
GET /data/v1/projects/{project_id}/items/{item_id}
接口返回结果里的data.attributes.description字段就是你要的Description值。

2. 确认权限与令牌有效性 #

检查你的Forge应用是否申请了data:read权限，且当前使用的访问令牌包含该权限——权限不足会导致核心元数据被过滤，无法返回Description字段。

3. 验证目标资源ID的正确性 #

确保请求中使用的item_id是文档对应的Item ID，而非版本ID或文件夹ID。可以通过你之前调用的文件夹内容接口，从返回的type="items"类型条目里提取正确的Item ID。

4. 排查版本相关特殊情况 #

• 如果文档存在多版本，若要获取特定版本的Description，需调用版本详情接口：
  GET /data/v1/projects/{project_id}/items/{item_id}/versions/{version_id}
  从data.attributes.description字段读取对应版本的描述。
• 确认项目环境为ACC，部分旧BIM 360接口在ACC环境下存在兼容性差异，优先使用ACC适配的Data Management接口。

补充：已尝试接口的局限性说明 #

• 自定义属性定义接口仅返回用户创建的自定义属性，不包含系统默认的Description。
• 文件夹内容接口仅返回条目基础元数据，不会返回完整的Description，必须调用详情接口获取。
• 成本属性接口针对成本模块属性，和文档核心元数据无关。

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