如何通过REST API创建Autodesk Construction Cloud(ACC)项目

• 目前支持通过REST API创建ACC类型项目。此前使用的BIM 360项目创建接口不兼容ACC，核心原因是两套产品的项目创建逻辑分属不同API体系，不存在跨产品的向前兼容设计。
• 公开文档检索时仅能找到更新项目头像的PATCH接口，是因为ACC的项目创建接口归类在账号管理（Account Admin）接口分类下，未放在通用项目接口列表中，容易被遗漏。

接口核心规范 #

• 请求方法：POST
• 接口路径：/construction/admin/v1/accounts/{accountId}/projects
• 鉴权要求：使用3-legged OAuth 2.0令牌，令牌需包含account:write权限范围，调用身份必须为对应ACC账号的账号管理员
• 响应规则：接口成功接收创建请求后返回202 Accepted状态码，响应体携带新建项目ID与状态轮询地址。项目创建为异步流程，需轮询至项目状态为active才代表创建完成，可正常投入使用。

最小可用请求体示例 #

{
  "name": "待同步的项目名称",
  "type": "Wallboard",
  "timezone": "Asia/Shanghai",
  "language": "zh-CN",
  "constructionType": "New Construction",
  "contractType": "Lump Sum",
  "startDate": "2024-06-01",
  "endDate": "2025-06-30",
  "country": "CN",
  "currency": "CNY"
}

调用注意事项 #

• 该接口仅支持创建ACC类型项目，无法用于创建旧版BIM 360项目，和原有BIM 360项目创建接口为平行独立的两套接口，不要混用路径
• 请求体中type字段固定传Wallboard对应标准ACC项目，不要传入BIM 360对应的项目类型值
• 项目创建完成后，后续的成员添加、服务激活、数据同步逻辑和原有BIM 360集成流程基本一致，可复用大部分现有代码逻辑

内容的提问来源于stack exchange，提问作者om.dev