外观
回调通知
本模块说明审查结果回调的接收方式。调用开启 AI 智能审查时传入 callbackUrl,平台会在任务审图成功后向该地址推送任务详情报文。
接口列表
| 接口 | 说明 |
|---|---|
| 审图结果回调 | 接收平台推送的审图结果报文 |
回调规则
| 项目 | 说明 |
|---|---|
| 触发时机 | 审图成功(任务状态为 SUCCESS)后触发 |
| 请求方式 | POST |
| 请求类型 | application/json |
| 回调地址维度 | 按「项目 ID + 专业」保存,有效期 30 天 |
| 调用方响应 | 返回 HTTP 2xx 即视为接收成功 |
建议实现
- 在业务系统中新增一个回调接收接口,例如
/openApi/backRcvResponse,并在开启 AI 智能审查时作为callbackUrl传入。 - 接收报文后先落库或入队,避免在回调接口中执行耗时逻辑。
- 立即返回 HTTP 2xx 以结束回调;业务处理交由异步任务执行。
- 若长时间未收到回调,可通过任务查询轮询任务状态作为兜底。