如何通过Data Management API设置Item的Description字段

• 上传时直接设置的正确方式：
  你使用的POST /projects/{project_id}/items端点本身支持设置Description字段，但需要把该字段放在请求体的指定位置——要在data.attributes对象中添加description字段，以下是请求体示例：

  {
    "jsonapi": {
      "version": "1.0"
    },
    "data": {
      "type": "items",
      "attributes": {
        "name": "示例文件.pdf",
        "description": "这是该文件的详细描述内容",
        "extension": {
          "type": "items:autodesk.core:File",
          "version": "1.0"
        }
      },
      "relationships": {
        "tip": {
          "data": {
            "type": "versions",
            "id": "{你的版本ID}"
          }
        },
        "parent": {
          "data": {
            "type": "folders",
            "id": "{目标文件夹ID}"
          }
        }
      }
    }
  }
  

• 上传后补改的方法：
  如果上传时未设置成功，也可以后续调用PATCH /items/{item_id}端点来更新Description字段，请求体示例如下：

  {
    "jsonapi": {
      "version": "1.0"
    },
    "data": {
      "type": "items",
      "id": "{你的文件Item ID}",
      "attributes": {
        "description": "更新后的文件描述内容"
      }
    }
  }
  

注意：无论使用哪种方式，都要确保请求的Content-Type设置为application/vnd.api+json，且你的认证令牌拥有对应的读写权限。

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