新增项目

接口概述

在当前企业下创建审图项目。项目创建成功后返回项目 ID，后续上传图纸、发起审图任务均需要携带该 ID。

服务端会自动为项目绑定企业下的关联用户作为项目创建人，并初始化各专业的项目配置，调用方无需传入用户信息。

请求地址

POST /createProject

请求头

参数	必填	说明
apiKey	是	API 访问凭证
Enterprise	是	企业标识
Platform	是	平台标识，取值参见快速开始
Content-Type	是	application/json

请求参数

参数	类型	必填	说明
name	String	是	项目名称，长度不超过 50 个字符
location	String	是	项目所在地 ID，可通过查询所有省与查询省下属市获取

请求示例

curl -X POST "https://openapi.bangtu-ai.com/openApi/createProject" \
  -H "apiKey: YOUR_API_KEY" \
  -H "Enterprise: YOUR_ENTERPRISE_ID" \
  -H "Platform: INSPECTOR" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "XX 产业园一期",
    "location": "330100"
  }'

返回结果

{
  "code": 200,
  "message": "success",
  "data": "1900123456789012345",
  "timestamp": 1784533680000
}

返回字段

字段	类型	说明
code	Number	通用响应码，200 表示成功
message	String	响应信息
data	String | null	创建成功的项目 ID；请求失败时为 null
timestamp	Number	服务端响应时间戳，单位为毫秒

响应码

code	说明
200	请求成功
500	请求失败，具体原因见 message

注意事项

• name 与 location 不能为空，name 超出 50 个字符会校验失败。
• 同一平台下不允许出现重名项目，重复创建会返回失败并提示「项目重名了」。
• location 必须是真实存在的行政区划 ID，否则返回「项目地址不存在」。
• 项目创建时 activity 默认开启，可直接用于上传图纸。