外观
查询图纸信息
接口概述
查询指定项目、指定专业下的图纸信息，返回目录、图框与比对图框列表，同时可用于轮询预审进度与预审结果。
请求地址
http
POST /queryDrawingTab请求头
| 参数 | 必填 | 说明 |
|---|---|---|
| apiKey | 是 | API 访问凭证 |
| Platform | 是 | 平台标识，取值参见快速开始 |
| Content-Type | 是 | application/json |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| projectId | String | 是 | 项目 ID |
| major | String | 是 | 专业，取值参见专业 |
| itemName | String | 否 | 子项名称，用于过滤指定子项 |
| isUnknownItem | Boolean | 否 | 是否查询未知子项，默认 false |
| frameTypeList | Array | 否 | 图框类型过滤，可选 DRAWING、DES、GENERAL_DES 等 |
| compareType | Number | 否 | 比较类型，0 为原始图框，1 为比对图框 |
| majorJointReview | Array | 否 | 会审专业列表 |
请求示例
bash
curl -X POST "https://openapi.bangtu-ai.com/openApi/queryDrawingTab" \
-H "apiKey: YOUR_API_KEY" \
-H "Platform: INSPECTOR" \
-H "Content-Type: application/json" \
-d '{
"projectId": "1900123456789012345",
"major": "BUILDING"
}'返回结果
json
{
"code": 200,
"message": "success",
"data": {
"directories": [],
"frames": [
{
"drawingId": "1900567890123456789",
"drawingName": "总平面图.dwg",
"drawingNo": "建施-01",
"drawingTitle": "一层平面图",
"itemName": "1#楼",
"type": "DRAWING",
"major": "BUILDING",
"layoutName": "Layout1",
"frameScale": "1:100",
"resultUrl": "openApi/frame/1900567890123456789.png",
"reviewStatus": true,
"entityNum": 1024,
"buildUsage": "RESIDENCE"
}
],
"compareFrames": []
},
"timestamp": 1784533680000
}返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
| code | Number | 通用响应码，200 表示成功 |
| message | String | 响应信息 |
| data | Object | 图纸数据 |
| timestamp | Number | 服务端响应时间戳，单位为毫秒 |
data 字段
| 字段 | 类型 | 说明 |
|---|---|---|
| directories | Array | 目录内容列表 |
| frames | Array | 图框列表 |
| compareFrames | Array | 比对图框列表 |
frames / compareFrames / directories 元素字段
| 字段 | 类型 | 说明 |
|---|---|---|
| drawingId | String | 图纸 ID |
| drawingName | String | 图纸名称 |
| drawingNo | String | 图号 |
| drawingTitle | String | 图名 |
| originalDrawingNo | String | 原始图号 |
| originalDrawingTitle | String | 原始图名 |
| projectName | String | 从图纸中解析出的工程名称 |
| itemName | String | 子项名称 |
| buildingNumberList | String | 楼栋号 |
| layoutId | String | 布局 ID |
| layoutName | String | 布局名称 |
| type | String | 图框类型 |
| major | String | 专业 |
| frameScale | String | 比例 |
| resultUrl | String | 图框截图地址 |
| zoom | Number | 截图缩放比率 |
| x1 / y1 | Number | 图框左上坐标 |
| x2 / y2 | Number | 图框右下坐标 |
| reviewStatus | Boolean | 审查状态，true 表示参与审查 |
| deleteState | Boolean | 删除状态 |
| useDirectoryDrawingTitle | Boolean | 是否使用目录图名 |
| entityNum | Number | 图源数 |
| frameMd5 | String | 图框 MD5 |
| buildUsage | String | 住宅用途 |
| mark | Boolean | 是否提示 |
| compareFrameId | String | 比对图框 ID |
响应码
| code | 说明 |
|---|---|
| 200 | 请求成功 |
| 500 | 请求失败 |
注意事项
projectId与major为必填，缺失时返回projectId and major are required。- 预审为异步过程，可定时调用本接口判断图框是否解析完成。