文档首页/ ISDP/ API参考/ API接口/ 智能安监/ 设备模板管理/ AI检测异步回调(API名称:processMsg)
更新时间:2026-08-10 GMT+08:00
分享

AI检测异步回调(API名称:processMsg)

功能介绍

该接口用于与客户系统对接AI检测异步回调。

相关API

接口名称

调用说明

获取Token

调用该接口获取到Token,再调用其他接口时,需要在请求消息头中添加“Authorization”,其值即为Token。

获取设备列表

调用该接口获取设备编号和isdp唯一设备ID。

AI检测异步回调时,需要输入设备编号;当msgType为device_alarm时,需要输入isdp唯一设备ID。

调用流程

图1 AI检测异步回调流程

URL

请求方式

HTTPS地址

服务架构

消息体类型

POST

https://isdp+域名/openapi/v1/receiveAiCallback/processMsg

OpenAPI

application/json

请求头

KEY

VALUE

是否必填

描述

Content-Type

application/json

是

无

Authorization

bearer ${access_token}

是

bearer +“ ”+5.2.1中获取的access_token的值

请求参数

参数

类型

是否必填

描述

msgId

String

是

消息ID

deviceId

String

是

设备编号

获取设备编号API请参见:摄像头列表查询(好望云平台)(API名称:getDeviceList)

deviceName

String

否

设备名称

channelType

String

否

通道类型

channelId

String

否

通道编号

channelName

String

否

通道名称

msgType

String

是

消息类型:

  • device_status:设备状态通知
  • device_alarm:智能告警通知

data

Json

是

消息数据

当msgType为device_alarm时,data格式如下:

参数

类型

是否必填

描述

alarmType

String

是

isdp唯一设备ID

获取isdp唯一设备ID API请参见:摄像头列表查询(好望云平台)(API名称:getDeviceList)

extendData

List

是

扩展字段

projectCode

String

否

项目编码

category

String

否

类别

itemID

String

否

审核项ID

timeStamp

String

否

时间戳

vedioProjectFlag

String

否

视频工程标志

optionType

String

否

类别

result

String

否

结果

resultByObjectList

String

否

审核项结果集

objectID

String

否

对象ID

result

String

否

审核结果

remarkCn

String

否

描述中文

remarkEn

String

否

描述英文

remarkNo

String

否

描述编号

num

String

否

数量

当msgType为device_ status时,data格式如下:

参数

类型

是否必填

描述

method

String

是

设备状态变更方法:

  • 渠道变更:channel_state_notice
  • 退出:logout
  • 接入:login

响应参数

参数

类型

描述

code

Int

状态

message

String

提示信息

result

String

结果

请求示例

{
    "msgId": "device_1225_ai_check--1_1609204598469",
    "msgType": "device_alarm",
    "data": [
        {
            "alarmType": "PPE",
            "extendData": {
                "projectCode": "",
                "category": "EHS",
                "itemID": "",
                "timeStamp": 1609204598975,
                "vedioProjectFlag": "N",
                "optionType": "0",
                "result": "N",
                "resultByObjectList": [
                    {
                        "objectID": "helmet",
                        "result": "N",
                        "remarkCn": "有人未穿戴 helmet",
                        "remarkEn": "Someone didn't dress helmet",
                        "remarkNo": "2003",
                        "num": 0
                    }, 
                    {
                        "objectID": "high_visible_vest",
                        "result": "N",
                        "remarkCn": "有人未穿戴 high_visible_vest",
                        "remarkEn": "Someone didn't dress high_visible_vest",
                        "remarkNo": "2003",
                        "num": 1
                    }
                ],
                "detailList": [
                    {
                        "photo": "R1S911D00020413320201229091638842125135",
                        "markedPhoto": "R1S219D00021005220201229091641005124841",
                        "objectList": [
                            {
                                 "objectID": "helmet",
                                 "result": "N",
                                 "remarkCn": "有人未穿戴 helmet",
                                 "remarkEn": "Someone didn't dress helmet",
                                 "remarkNo": "2003",
                                 "num": 0
                             },
                            {
                                 "objectID": "high_visible_vest",
                                 "result": "N",
                                 "remarkCn": "有人未穿戴 high_visible_vest",
                                 "remarkEn": "Someone didn't dress high_visible_vest",
                                 "remarkNo": "2003",
                                 "num": 1
                             }
                         ],
                         "picType": "P",
                         "result": "N"
                     }
                 ]
             }
         }
     ],
     "deviceId": "device_1225_ai_check--1"
}

响应示例

{
    "code": "1",
    "message": "success",
    "result": null
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

相关文档