审图结果回调

接口概述

回调接收接口。当审图任务成功（状态为 SUCCESS）后，平台会向调用方在开启 AI 智能审查时传入的 callbackUrl 以 POST 方式推送任务详情报文，供业务系统实时获取审查结果。

调用方可直接复用本接口作为回调地址，也可自行实现等价逻辑。

请求地址

POST /backRcvResponse

请求头

参数	必填	说明
apiKey	否	由调用方自行决定回调地址是否需要鉴权
Content-Type	是	application/json

请求参数

请求体为任务详情报文，结构参见审图任务图纸详情，主要字段如下：

参数	类型	说明
id	String	任务 ID
name	String	任务名称
projectId	String	项目 ID
projectName	String	项目名称
major	String	专业
majorName	String	专业名称
reviewStatus	String	审图状态
statusName	String	审图状态名称
proofreadingStatus	String	校审状态
progress	Number	任务进度
frameQty	Number	图框数
forceCount	Number	违反强条数量
opinionCount	Number	一般意见数量
wordUrl	String	WORD 报告地址
pdfUrl	String	PDF 报告地址
reviewRes	Array	审查结果，按子项分组

回调报文示例

{
  "id": "1900789012345678901",
  "name": "1#楼建筑施工图审查",
  "projectId": "1900123456789012345",
  "projectName": "XX 产业园一期",
  "major": "BUILDING",
  "majorName": "建筑",
  "reviewStatus": "SUCCESS",
  "statusName": "审图成功",
  "progress": 100,
  "frameQty": 12,
  "forceCount": 3,
  "opinionCount": 5,
  "wordUrl": "openApi/report/1900789012345678901.docx",
  "pdfUrl": "openApi/report/1900789012345678901.pdf",
  "reviewRes": [
    {
      "itemName": "1#楼",
      "buildUsage": "RESIDENCE",
      "forceViolateSpecList": [],
      "noForceViolateSpecList": [],
      "infoLackList": [],
      "opinionList": []
    }
  ]
}

返回结果

调用方接收成功后返回 HTTP 2xx 即可。建议返回：

{
  "code": 200,
  "message": "success"
}

平台侧处理失败时会返回：

{
  "status": "error",
  "message": "处理失败"
}

响应码

code	说明
200	接收成功
500	处理失败

注意事项

• 回调仅在审图成功时触发，失败任务不会回调，请通过任务查询兜底获取失败原因。
• 回调地址按「项目 ID + 专业」维度保存，同一项目同一专业重复发起任务时，后传入的地址会覆盖前一次。
• 回调为单向推送，未做重试保证，业务侧需保证接口幂等。
• 建议在回调接口中仅做落库、入队等轻量操作，并立即返回 HTTP 200。