外观
漏报规范存储
接口概述
将人工校审发现的漏审意见(平台未识别到的问题)录入任务,支持关联规范要点、图框坐标与文字描述。
请求地址
http
POST /addProofreadingOpinions请求头
| 参数 | 必填 | 说明 |
|---|---|---|
| apiKey | 是 | API 访问凭证 |
| Content-Type | 是 | application/json |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| taskId | String | 是 | 任务 ID |
| proofreadingType | Number | 是 | 校审类型,取值参见校审类型 |
| itemName | String | 否 | 子项名称 |
| frameId | String | 否 | 图框 ID |
| x1 / y1 | Number | 否 | 意见标注左上坐标 |
| x2 / y2 | Number | 否 | 意见标注右下坐标 |
| desc | String | 否 | 校审文字描述,最长 500 个字符 |
| specPointsDTO | Object | 否 | 规范要点信息,proofreadingType 为 1 时建议传入 |
specPointsDTO 字段
| 参数 | 类型 | 说明 |
|---|---|---|
| bookId | String | 规范书 ID |
| bookAiId | String | 规范书 ID(对应算法) |
| bookNo | String | 规范书编号 |
| bookName | String | 规范书名称 |
| specNum | String | 规范编号 |
| specContent | String | 规范内容 |
| entryId | String | 要点编号 |
| entryContent | String | 要点内容 |
| specIsForce | Boolean | 规范是否为强条 |
| entryIsForce | Boolean | 要点是否为强条 |
请求示例
bash
curl -X POST "https://openapi.bangtu-ai.com/openApi/addProofreadingOpinions" \
-H "apiKey: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"taskId": "1900789012345678901",
"proofreadingType": 1,
"itemName": "1#楼",
"frameId": "1900567890123456789",
"x1": 120.5,
"y1": 88.2,
"x2": 260.0,
"y2": 110.4,
"desc": "疏散楼梯间未设置乙级防火门",
"specPointsDTO": {
"bookNo": "GB50016-2014",
"bookName": "建筑设计防火规范",
"specNum": "6.4.3",
"specContent": "疏散楼梯间应符合下列规定……",
"entryIsForce": true
}
}'返回结果
json
{
"code": 200,
"message": "success",
"data": null,
"timestamp": 1784533680000
}返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
| code | Number | 通用响应码,200 表示成功 |
| message | String | 响应信息 |
| data | String | null | 存储结果说明,通常为 null |
| timestamp | Number | 服务端响应时间戳,单位为毫秒 |
响应码
| code | 说明 |
|---|---|
| 200 | 请求成功 |
| 500 | 请求失败,具体原因见 message |
注意事项
taskId与proofreadingType为必填。desc超过 500 个字符会校验失败。- 坐标与图框 ID 建议取自审图任务图纸快照返回的信息。