ACC users:import接口调用后用户未同步至项目问题咨询

调用ACC的users:import接口后返回jobId仅代表任务已提交，不意味着执行成功，按以下步骤排查：

• 优先查询异步任务状态：使用返回的jobId调用GET /construction/admin/v2/jobs/{jobId}接口，查看任务的执行状态和错误详情。这是最直接定位问题的方式，权限不足、用户信息无效等问题都会在这里返回具体错误。
• 验证权限配置：
  • 2-legged OAuth应用必须具备Account Admin或Project Admin权限范围；
  • 请求头中的User-Id对应的用户，必须是目标项目的管理员或账户级管理员，否则任务会被拒绝执行。
• 检查用户信息有效性：
  • 确保用户邮箱是已注册的有效Autodesk账户邮箱（部分环境不支持自动创建新账户）；
  • companyId必须属于当前项目所在的账户，且与用户实际所属公司匹配；
  • roleIds必须是目标项目的有效角色ID，可通过GET /construction/admin/v2/projects/{projectId}/roles接口获取项目可用角色，避免使用通用或无效的角色ID。
• 确认产品权限与项目配置匹配：检查请求中products的key是否是目标项目已开通的服务，未开通的服务权限设置不会影响用户添加，但如果存在配置冲突可能导致任务异常。
• 等待异步任务执行完成：新用户创建或批量添加可能需要1-5分钟的处理时间，提交任务后不要立即查看，等待片刻再检查项目用户列表。

请求与响应详情 #

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_here}"
}

Data: {
  "users": [
    {
      "firstName": "nya",
      "lastName": "nyaa",
      "email": "nya.nyaa@mail.com",
      "companyId": {company_id_here},
      "roleIds": [
        "287d5cc2-9008-462c-96e5-c9491db85d97",
        "cda845af-05f0-4c46-9108-71b993946c35",
        "b8e84a73-7506-4d3f-b221-93691df2a359"
      ],
      "products": [
        {
          "key": "projectAdministration",
          "access": "none"
        },
        {
          "key": "designCollaboration",
          "access": "member"
        },
        {
          "key": "build",
          "access": "member"
        },
        {
          "key": "cost",
          "access": "member"
        },
        {
          "key": "modelCoordination",
          "access": "member"
        },
        {
          "key": "docs",
          "access": "member"
        },
        {
          "key": "insight",
          "access": "member"
        },
        {
          "key": "takeoff",
          "access": "member"
        }
      ]
    },
    {
      "firstName": "nya",
      "lastName": "two",
      "email": "nya.two@mail.com",
      "companyId": {company_id_here},
      "roleIds": [
        "287d5cc2-9008-462c-96e5-c9491db85d97",
        "cda845af-05f0-4c46-9108-71b993946c35",
        "b8e84a73-7506-4d3f-b221-93691df2a359"
      ],
      "products": [
        {
          "key": "projectAdministration",
          "access": "none"
        },
        {
          "key": "designCollaboration",
          "access": "member"
        },
        {
          "key": "build",
          "access": "member"
        },
        {
          "key": "cost",
          "access": "member"
        },
        {
          "key": "modelCoordination",
          "access": "member"
        },
        {
          "key": "docs",
          "access": "member"
        },
        {
          "key": "insight",
          "access": "member"
        },
        {
          "key": "takeoff",
          "access": "member"
        }
      ]
    }
  ]
}

Received response:
{
  "jobId": "1956810c-40da-4d20-853d-5010ce9c0697"
}

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