如何正确获取BIM 360图纸版本详情？API调用报错解决

1. 正确获取版本信息的步骤 #

你遇到的400错误核心原因是项目ID格式不匹配或使用了错误的Item标识，正确流程如下：

• 从Construction Sheets API返回的图纸数据中，提取itemUrn（或sourceFileUrn，格式类似urn:adsk.wipprod:dm.lineage:xxxxxx），这是对应Data Management中文件Item的唯一标识。
• 调用Data Management API时，必须使用绑定后的BIM 360项目ID（格式为b.{原始项目ID}，比如b.12345678-1234-1234-1234-1234567890ab），不能直接用Sheets API中使用的纯数字/字符串项目ID。
• 将提取到的完整itemUrn作为{item_id}参数传入版本查询端点即可。

2. BIM 360与ACC的API端点差异 #

基础的Data Management和Construction Sheets API端点对于BIM 360和ACC完全通用，核心差异仅在于：

• 项目ID格式：两者都要求使用b.{项目ID}格式的绑定ID，无本质区别。
• 进阶功能：ACC支持部分BIM 360未覆盖的新API（如文档集管理），但获取图纸版本的端点逻辑一致。

3. URN格式要求 #

不需要额外转换格式，直接使用Sheets API返回的完整URN即可，但需注意：

• URN必须保留完整前缀（如urn:adsk.wipprod:dm.lineage:），不能截断。
• 若URN包含特殊字符（实际场景中极少出现），需进行URL编码后再传入。

示例Curl命令 #

1. 获取BIM 360图纸列表 #

curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  "https://developer.api.autodesk.com/construction/sheets/v1/projects/YOUR_RAW_PROJECT_ID/sheets"

（注：YOUR_RAW_PROJECT_ID是BIM 360项目的原始ID，即Sheets API中使用的ID）

2. 获取图纸对应的版本信息 #

从第一步返回的图纸数据中提取itemUrn，替换下面的YOUR_ITEM_URN，同时使用绑定后的项目ID：

curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  "https://developer.api.autodesk.com/data/v1/projects/b.YOUR_RAW_PROJECT_ID/items/YOUR_ITEM_URN/versions"

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