查询预审信息

接口概述

查询指定项目、指定专业下预审后的图纸文件列表，返回每个文件的预审状态、预审进度与图框数量，用于判断图纸是否可以发起审查任务。

请求地址

http

POST /selectByProjectIdAndMajor?major={major}&projectId={projectId}

请求头

参数	必填	说明
apiKey	是	API 访问凭证
Platform	是	平台标识，取值参见快速开始

请求参数

参数	类型	必填	说明
major	String	是	专业，取值参见专业
projectId	String	是	项目 ID

请求示例

bash

curl -X POST "https://openapi.bangtu-ai.com/openApi/selectByProjectIdAndMajor?major=BUILDING&projectId=1900123456789012345" \
  -H "apiKey: YOUR_API_KEY" \
  -H "Platform: INSPECTOR"

返回结果

json

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "drawingName": "总平面图.dwg",
      "fileType": "DRAWING",
      "filePath": "openApi/1900123456789012345/总平面图.dwg",
      "status": "SUCCESS",
      "proofreadStatus": "SUCCESS",
      "progress": 100,
      "frameCount": 12,
      "compareType": 0,
      "roundedSize": 2.35,
      "createdTime": "2026-07-19 10:20:30",
      "updatedByName": "张三",
      "estimateFrameDetectionTime": 120,
      "t3Converted": false
    }
  ],
  "timestamp": 1784533680000
}

返回字段

字段	类型	说明
code	Number	通用响应码，`200` 表示成功
message	String	响应信息
data	Array	预审后的文件列表
timestamp	Number	服务端响应时间戳，单位为毫秒

data 元素字段

字段	类型	说明
drawingName	String	文件名称
fileType	String	文件类型，取值参见图纸类型
calcItemName	String	计算书子项名称
filePath	String	文件路径
status	String	预审解析状态
proofreadStatus	String	图纸校审状态
failReason	String	解析失败原因，解析失败时返回
progress	Number	预审进度，`0` ~ `100`
frameCount	Number	识别到的图框数
binUrl	String	序列化文件地址
updatedBy / updatedByName	String	上传人 ID / 名称
createdTime	String	上传时间
estimateFrameDetectionTime	Number	预计预审耗时（秒），大于 300 表示超过 5 分钟
t3Converted	Boolean	是否为 T3 转换后的图纸
originFileId	String	转换前的源文件 ID
compareType	Number	比对类型，`0` 为原图纸，`1` 为比对图纸
roundedSize	Number	文件大小，单位为 MB
frames	Array	图框信息，结构参见查询图纸信息

响应码

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

注意事项

major 与 projectId 为必填。
status 为解析失败时，可通过 failReason 查看失败原因。
预审完成（frameCount 大于 0）后，方可调用开启 AI 智能审查。

查询预审信息 ​

接口概述 ​

请求地址 ​

请求头 ​

请求参数 ​

请求示例 ​

返回结果 ​

返回字段 ​

data 元素字段 ​

响应码 ​

注意事项 ​

查询预审信息

接口概述

请求地址

请求头

请求参数

请求示例

返回结果

返回字段

data 元素字段

响应码

注意事项