调用ACC Account Admin API users:import端点返回500错误求助

问题概述 #

调用ACC的users:import端点时持续返回500内部服务器错误，此前其他端点调用均正常。已确认项目状态为活跃、管理员权限配置正确、应用权限无误、双腿令牌作用域有效。文档中指向该端点的链接当前返回404。

错误详情 #

Status Code: 500
Response Headers: {'Server': 'nginx', 'Date': 'Sun, 03 Nov 2024 20:58:49 GMT', 'Content-Type': 'application/json; charset=utf-8', 'Transfer-Encoding': 'chunked', 'Connection': 'keep-alive', 'x-dns-prefetch-control': 'off', 'x-frame-options': 'SAMEORIGIN', 'strict-transport-security': 'max-age=31536000; includeSubDomains; preload', 'x-download-options': 'noopen', 'x-content-type-options': 'nosniff', 'x-xss-protection': '1; mode=block', 'request-id': '2992795c45bc6abd', 'vary': 'Origin, Accept-Encoding', 'access-control-allow-credentials': 'true', 'etag': 'W/"86-5CR7ttxfAA9VBRki4F937nxFYpM"', 'response-time': '29.876ms', 'content-encoding': 'gzip', 'ratelimit-value': '600', 'ratelimit-remaining': '599', 'x-request-id': 'ec507692-958e-4de5-94b9-6a86e3ee64a7'}
Response Body: {"status":500,"type":"","id":"2992795c45bc6abd","title":"Internal Server Error","detail":"Cannot convert undefined or null to object"}
API request failed: 500 Server Error: Internal Server Error for url: https://developer.api.autodesk.com/construction/admin/v2/projects/{project_id_here}/users:import
Error details: {"status":500,"type":"","id":"2992795c45bc6abd","title":"Internal Server Error","detail":"Cannot convert undefined or null to object"}

请求信息 #

URL: https://developer.api.autodesk.com/construction/admin/v2/projects/{project_id_here}/users:import
Headers: {
  "Authorization": "Bearer {token_here}",
  "Content-Type": "application/json",
  "User-Id": "{user_id_for_two_legged_auth_here}"
}
Data: [
  {
    "email": "{admin_email_here}",
    "companyId": "{company_id_here}",
    "roleIds": [
      "287d5cc2-9008-462c-96e5-c9491db85d97",
      "cda845af-05f0-4c46-9108-71b993946c35",
      "b8e84a73-7506-4d3f-b221-93691df2a359"
    ],
    "products": [
      {
        "key": "takeoff",
        "access": "member"
      },
      {
        "key": "projectAdministration ",
        "access": "administrator"
      }
    ]
  },
  {
    "email": "{user_email_here}",
    "companyId": "{company_id_here}",
    "roleIds": [
      "287d5cc2-9008-462c-96e5-c9491db85d97",
      "cda845af-05f0-4c46-9108-71b993946c35",
      "b8e84a73-7506-4d3f-b221-93691df2a359"
    ],
    "products": [
      {
        "key": "takeoff",
        "access": "member"
      },
      {
        "key": "projectAdministration ",
        "access": "none"
      }
    ]
  }
]

解决方案 #

• 修正产品key的空格问题：请求数据中projectAdministration字段后存在多余空格，导致API无法识别该产品，引发空值转换错误。将两个"projectAdministration "修改为"projectAdministration"。
• 使用项目专属角色ID：硬编码的roleIds不具备通用性，每个项目的角色ID是唯一的。通过GET /construction/admin/v2/projects/{project_id}/roles端点获取当前项目的有效角色ID，替换请求中的硬编码值。
• 检查请求数据格式：确保所有字段值无多余空格、格式正确，例如access字段需为member、administrator或none中的有效值。

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