任务查询

接口概述

查询指定项目、指定专业下的审查任务列表，用于获取任务状态、进度、图框数与报告地址。可用于轮询任务执行进度。

请求地址

http

POST /taskQuery

请求头

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

请求参数

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

请求示例

bash

curl -X POST "https://openapi.bangtu-ai.com/openApi/taskQuery" \
  -H "apiKey: YOUR_API_KEY" \
  -H "Platform: INSPECTOR" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "1900123456789012345",
    "majorEnum": "BUILDING"
  }'

返回结果

json

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "id": "1900789012345678901",
      "name": "1#楼建筑施工图审查",
      "projectId": "1900123456789012345",
      "projectName": "XX 产业园一期",
      "major": "BUILDING",
      "majorName": "建筑",
      "reviewStatus": "SUCCESS",
      "statusName": "审图成功",
      "proofreadStatus": "COMPLETE",
      "progress": 100,
      "frameQty": 12,
      "checkedFrameQty": 12,
      "errorCount": 8,
      "errorSpecCount": 3,
      "retrial": false,
      "retrialNum": 1,
      "wordUrl": "openApi/report/1900789012345678901.docx",
      "pdfUrl": "openApi/report/1900789012345678901.pdf",
      "reviewStartTime": "2026-07-19 10:30:00",
      "reviewEndTime": "2026-07-19 10:36:12"
    }
  ],
  "timestamp": 1784533680000
}

返回字段

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

data 元素字段

字段	类型	说明
id	String	任务 ID
name	String	任务名称
projectId / projectName	String	项目 ID / 项目名称
major / majorName	String	专业编码 / 专业名称
reviewStatus	String	审图状态，取值参见审图状态
statusName	String	审图状态名称
proofreadStatus	String	校审状态，取值参见校审状态
progress	Number	任务进度，`0` ~ `100`
frameQty	Number	图框数
checkedFrameQty	Number	当前任务图框数
calCheckedFrameQty	Number	参与审查的图框数（已乘以专业系数）
itemCount	Number	子项数量
errorCount	Number	错误个数
errorSpecCount	Number	违规条数
calcCount	Number	计算书对比数量
wordUrl	String	WORD 报告地址
pdfUrl	String	PDF 报告地址
excelUrl	String	问题图纸 Excel 地址
failReason	String	审图失败原因
codeAndMessage	String	任务失败原因
retrial	Boolean	是否为重审任务
retrialNum	Number	重审次数，大于 1 表示重审过
taskPid	String	重审父任务 ID
reviewStartTime	String	审图开始时间
reviewEndTime	String	审图结束时间
completeTime	String	完成时间
proofreadingTime	String	校审时间
downloadNum	Number	报告下载次数，大于 1 表示报告已被下载
queueNumber	Number	队列排序，`0` 表示正在执行
creatorName	String	任务创建人名称
partnerCode	String	合作平台编码，`BANGTU` 表示帮图

响应码

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

注意事项

projectId 与 majorEnum 为必填，缺失时返回 projectId and major are required。
建议轮询间隔不低于 10 秒，避免请求过于频繁。
reviewStatus 为 SUCCESS 时可获取审查结果与报告。

任务查询 ​

接口概述 ​

请求地址 ​

请求头 ​

请求参数 ​

请求示例 ​

返回结果 ​

返回字段 ​

data 元素字段 ​

响应码 ​

注意事项 ​

任务查询

接口概述

请求地址

请求头

请求参数

请求示例

返回结果

返回字段

data 元素字段

响应码

注意事项