调用APS Data Management API更新Item属性时遇BAD_INPUT错误求助

核心问题：请求体需使用Item的版本ID #

你遇到的BAD_INPUT错误，大概率是因为请求体里填错了ID——这个接口要求在relationships.tip.data.id位置填写Item的版本ID，而非URL路径中的Item ID。

获取版本ID的方法 #

调用GET /projects/{project_id}/items/{item_id}接口，返回数据里的relationships.tip.data.id字段就是当前Item的最新版本ID。

正确的请求体示例 #

{
  "data": {
    "type": "items",
    "id": "<URL路径中的Item ID>",
    "attributes": {
      "name": "更新后的文件名",
      "description": "更新后的描述"
    },
    "relationships": {
      "tip": {
        "data": {
          "type": "versions",
          "id": "<获取到的版本ID>"
        }
      }
    }
  }
}

额外注意事项 #

• 请求头必须包含Content-Type: application/vnd.api+json，这是API强制要求的媒体类型，缺失会直接触发BAD_INPUT。
• 若要更新自定义属性，需将字段放在attributes.extension.data下，示例：

"attributes": {
  "extension": {
    "type": "items:autodesk.core:File",
    "data": {
      "ProjectCode": "PROJ-001",
      "Category": "Design"
    }
  }
}

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