AI结果回传接口
背景
AI结果通常需要回传给业务系统、工单系统或空间治理平台。接口设计要支持复核、追溯、地图展示和后续处置。
核心内容
- 结果标识:resultId、taskId、mediaId。
- 识别信息:类别、置信度、检测框或图斑。
- 证据信息:原图、截图、视频片段、采集时间。
- 位置信息:经[坐标已隐藏]图斑几何、坐标系。
- 状态信息:待复核、已确认、误报、已处置。
项目落地关注点
- 下游系统如果要复现地图展示,必须接收几何、坐标系和样式或状态字段。
- 结果回传前还是回传后复核,需要在流程上先确定。
- 接口失败要有重试和人工补发能力。
示例字段
{
"resultId": "待填写",
"taskId": "待填写",
"category": "待填写",
"confidence": 0.0,
"geometry": {
"type": "Point",
"coordinates": [0, 0]
},
"coordinateSystem": "待确认",
"evidenceUrl": "待填写",
"status": "pending_review"
}
验收/风险
- 检查下游能否按接口字段还原问题位置和证据。
- 检查重复推送是否会造成重复问题单。
- 检查失败重试是否有日志和状态提示。
待补充
- 补充实际接口地址和认证方式。
- 补充错误码与重试规则。