外观
审图任务图纸快照
接口概述
根据任务 ID 查询该任务下所有图框的快照信息，包含图框截图地址、坐标、图号图名、子项信息等，用于在业务系统中还原审查时的图纸范围。
请求地址
http
POST /frameSnapshotForOpenApi?taskId={taskId}请求头
| 参数 | 必填 | 说明 |
|---|---|---|
| apiKey | 是 | API 访问凭证 |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| taskId | String | 是 | 任务 ID |
请求示例
bash
curl -X POST "https://openapi.bangtu-ai.com/openApi/frameSnapshotForOpenApi?taskId=1900789012345678901" \
-H "apiKey: YOUR_API_KEY"返回结果
json
{
"code": 200,
"message": "success",
"data": [
{
"drawingId": "1900567890123456789",
"taskId": "1900789012345678901",
"drawingName": "总平面图.dwg",
"drawingNo": "建施-01",
"drawingTitle": "一层平面图",
"itemName": "1#楼",
"type": "DRAWING",
"major": "BUILDING",
"layoutName": "Layout1",
"frameScale": "1:100",
"resultUrl": "openApi/frame/1900567890123456789.png",
"zoom": 100,
"x1": 0,
"y1": 0,
"x2": 841,
"y2": 594,
"reviewStatus": true,
"entityNum": 1024,
"buildUsage": "RESIDENCE"
}
],
"timestamp": 1784533680000
}返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
| code | Number | 通用响应码，200 表示成功 |
| message | String | 响应信息 |
| data | Array | 图框快照列表 |
| timestamp | Number | 服务端响应时间戳，单位为毫秒 |
data 元素字段
| 字段 | 类型 | 说明 |
|---|---|---|
| drawingId | String | 图纸 ID |
| taskId | String | 任务 ID |
| originalFrameId | String | 原始图框 ID |
| drawingName | String | 图纸名称 |
| drawingNo / originalDrawingNo | String | 图号 / 原始图号 |
| drawingTitle / originalDrawingTitle | String | 图名 / 原始图名 |
| projectName / originalProjectName | String | 工程名称 / 原始工程名称 |
| itemName / originalItemName | String | 子项名称 / 原始子项名称 |
| type | String | 图框类型 |
| major / originalMajor | String | 专业 / 原始专业 |
| dwgMajor | String | 图签显示专业 |
| layoutId / layoutName | String | 布局 ID / 布局名称 |
| frameScale | String | 比例 |
| resultUrl | String | 图框截图地址 |
| zoom | Number | 截图缩放比率 |
| x1 / y1 | Number | 图框左上坐标 |
| x2 / y2 | Number | 图框右下坐标 |
| reviewStatus | Boolean | 审查状态，true 表示参与审查 |
| useDirectoryDrawingTitle | Boolean | 是否使用目录图名 |
| buildUsage | String | 住宅类型 |
| entityNum | Number | 图元数 |
| otherProxyEntityNum | Number | 其他代理图源数 |
| tzProxyEntityNum | Number | 天正代理图源数 |
| frameMd5 | String | 图框 MD5 |
| deleteState / deleteTime | - | 删除状态 / 删除时间 |
| signLoc | String | 图签坐标 |
| layoutFileName | String | 图框图源文件 |
| frameIsModel | Boolean | 布局类型 |
| layoutInfoFileName | String | 图框布局信息文件 |
| layerUrl | String | 图层信息文件地址 |
响应码
| code | 说明 |
|---|---|
| 200 | 请求成功 |
| 500 | 请求失败 |
注意事项
taskId不能为空，否则返回「任务id为空」。resultUrl为图框截图地址，配合文件下载接口可下载图片。