帮图开放API

Appearance

图纸基本信息识别任务创建 ​

接口概述 ​

上传 DWG 图纸并创建基本信息识别任务。接口采用异步处理方式：请求成功后立即返回任务 ID 和初始状态，图纸解析、图框及图签定位、图元拆分和图签信息识别将在后台继续执行。

本接口返回成功仅表示任务创建成功，不表示图纸识别已经完成。请保存返回的 taskId，用于后续查询任务状态和识别结果。

请求地址 ​

http
POST /pre/createPreTask

请求头 ​

参数必填说明
apiKey是API 访问凭证，值为 YOUR_API_KEY
Content-Type是使用 multipart/form-data 上传文件；调用方通常无需手动设置 boundary

请求参数 ​

参数类型必填说明
fileFile是待识别的 DWG 图纸文件

请求示例 ​

bash
curl -X POST "https://openapi.bangtu-ai.com/openApi/pre/createPreTask" \
  -H "apiKey:  YOUR_API_KEY" \
  -F "file=@example.dwg"

返回结果 ​

json
{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "1900123456789012345",
    "status": "RUNNING",
    "type": "PRE",
    "createTime": "2026-07-20T15:48:00.000+08:00",
    "endTime": null,
    "logs": []
  },
  "timestamp": 1784533680000
}

返回字段 ​

字段类型说明
codeNumber通用响应码，200 表示成功，500 表示失败
messageString响应信息
dataObject | null创建成功后的任务信息；请求失败时为 null
timestampNumber服务端响应时间戳，单位为毫秒

响应码 ​

code说明
200请求成功
500请求失败

data 字段 ​

字段类型说明
taskIdString任务唯一标识，后续查询任务状态和结果时使用
statusString当前任务状态；创建成功时为 RUNNING
typeString任务类型；图纸基本信息识别固定为 PRE
createTimeString任务创建时间
endTimeString | null任务结束时间；任务刚创建时为 null
logsArray任务执行日志；任务刚创建时通常为空数组

任务状态 ​

状态说明
RUNNING任务执行中
SUCCESS任务执行完成
FAILED任务执行失败

异步调用流程 ​

  1. 调用本接口上传 DWG 文件并创建识别任务。
  2. 从响应的 data.taskId 获取并保存任务 ID。
  3. 使用任务 ID 查询任务执行状态。
  4. 状态变为 SUCCESS 后获取图纸基本信息识别结果；状态变为 FAILED 时查看任务日志。

注意事项 ​

  • 上传字段名必须为 file，请求类型必须为 multipart/form-data。
  • 请勿通过本接口的 HTTP 等待时间判断识别是否完成。
  • 同一图纸的重复上传会创建不同的任务 ID。
  • 任务创建后应以任务状态查询接口返回的状态作为最终执行依据。