任务状态查询

接口概述

根据建筑构件识别任务 ID 查询任务当前状态、创建时间、结束时间和执行日志。

推荐每隔 3 至 5 秒查询一次。任务状态变为 SUCCESS 或 FAILED 后应停止轮询。

请求地址

GET /result/taskStatusData

请求头

参数	必填	说明
apiKey	是	API 访问凭证，值为 YOUR_API_KEY

查询参数

参数	类型	必填	说明
taskId	String	是	建筑构件识别任务创建接口返回的任务唯一标识

请求示例

curl -G "https://openapi.bangtu-ai.com/openApi/result/taskStatusData" \
  -H "apiKey:  YOUR_API_KEY" \
  --data-urlencode "taskId=1900123456789012346"

返回结果

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "1900123456789012346",
    "status": "RUNNING",
    "type": "BUILDING_CV",
    "createTime": "2026-07-20T17:06:00.000+08:00",
    "endTime": null,
    "logs": [
      {
        "message": "识别建筑图框内容开始...",
        "time": "2026-07-20 17:06:00"
      }
    ]
  },
  "timestamp": 1784538365000
}

返回字段

字段	类型	说明
code	Number	通用响应码，200 表示成功，500 表示失败
message	String	响应信息
data	Object | null	任务状态信息；请求失败或未查询到任务时可能为 null
timestamp	Number	服务端响应时间戳，单位为毫秒

data 字段

字段	类型	说明
taskId	String	建筑构件识别任务唯一标识
status	String	当前任务状态：RUNNING、SUCCESS 或 FAILED
type	String	任务类型；建筑构件识别任务为 BUILDING_CV
createTime	String	任务创建时间
endTime	String | null	任务结束时间；执行中为 null
logs	Array	任务执行日志列表

logs 字段

字段	类型	说明
message	String	日志消息内容
time	String	日志记录时间，格式为 yyyy-MM-dd HH:mm:ss

任务状态

状态	是否继续轮询	说明
RUNNING	是	任务正在执行，建议等待 3 至 5 秒后再次查询
SUCCESS	否	任务执行成功，可以继续获取建筑构件识别结果
FAILED	否	任务执行失败，应停止轮询并查看任务日志

调用流程

1. 调用建筑构件识别任务创建接口，获取 taskId。
2. 每隔 3 至 5 秒调用本接口查询任务状态。
3. 状态为 RUNNING 时继续轮询。
4. 状态为 SUCCESS 或 FAILED 时停止轮询。

注意事项

• taskId 应使用建筑构件识别任务创建接口返回的值。
• taskId 应按字符串传递，不要转换为数字，避免长整型精度丢失。
• code 表示本次状态查询请求是否成功，任务是否执行成功应以 data.status 为准。