外观
开启 AI 智能审查
接口概述
创建正式审查任务（兼容订单、支付等流程），平台将异步执行 AI 智能审查。可通过 isRecheck 对已有任务发起重审，通过 callbackUrl 订阅审查结果回调。
请求地址
http
POST /checkDrawingTask请求头
| 参数 | 必填 | 说明 |
|---|---|---|
| apiKey | 是 | API 访问凭证 |
| Tenant | 是 | 租户标识 |
| Enterprise | 是 | 企业标识 |
| project | 是 | 项目标识，需与请求体 projectId 一致 |
| Platform | 是 | 平台标识，取值参见快速开始 |
| Content-Type | 是 | application/json |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| taskName | String | 是 | 任务名称 |
| projectId | String | 是 | 项目 ID |
| major | String | 是 | 专业，取值参见专业 |
| majorJointReview | Array | 否 | 会审专业列表 |
| isRecheck | Boolean | 否 | 是否重审，true 表示对原任务发起重审 |
| frameList | Array | 否 | 指定参与审查的图框，不传则按预审结果中 reviewStatus 为 true 的图框执行 |
| compareFrames | Array | 否 | 比对图框列表 |
| calcCmpTypeList | Array | 否 | 结构计算书对比构建类型 |
| callbackUrl | String | 否 | 审查结果回调地址，传入后平台在任务完成时推送结果 |
请求示例
bash
curl -X POST "https://openapi.bangtu-ai.com/openApi/checkDrawingTask" \
-H "apiKey: YOUR_API_KEY" \
-H "Tenant: YOUR_TENANT_ID" \
-H "Enterprise: YOUR_ENTERPRISE_ID" \
-H "project: 1900123456789012345" \
-H "Platform: INSPECTOR" \
-H "Content-Type: application/json" \
-d '{
"taskName": "1#楼建筑施工图审查",
"projectId": "1900123456789012345",
"major": "BUILDING",
"isRecheck": false,
"callbackUrl": "https://your-domain.com/openApi/backRcvResponse"
}'返回结果
json
{
"code": 200,
"message": "success",
"data": {
"taskId": "1900789012345678901"
},
"timestamp": 1784533680000
}返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
| code | Number | 通用响应码，200 表示成功 |
| message | String | 响应信息 |
| data | Object | null | 创建成功的任务信息；请求失败时为 null |
| timestamp | Number | 服务端响应时间戳，单位为毫秒 |
响应码
| code | 说明 |
|---|---|
| 200 | 请求成功 |
| 500 | 请求失败，具体原因见 message |
注意事项
projectId、major、taskName、Tenant、Enterprise、project均为必填，缺失时返回参数校验失败。- 平台会校验图框数与费用：图框数为 0 时无需支付；签约且在有效期内直接放行；帮图币余额充足时按帮图币扣费；否则进入试用限制校验。
- 免费试用校验失败时返回「免费试用次数不足或者免费图框数不足,请充值后再发起识图」。
- 同一项目下的其他专业任务未完成时，可能被拦截，需等待其他专业任务结束后再发起。
- 传入
callbackUrl后，回调地址会按「项目 + 专业」维度保存 30 天，任务完成时平台会向该地址推送审查结果，报文结构参见审图结果回调。