
# AI检测异步回调（API名称：processMsg）
#### 功能介绍
该接口用于与客户系统对接AI检测异步回调。
#### 相关API
| **接口名称**                                                             | **调用说明**                                                                                                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。                                                                                 |
| [获取设备列表](https://support.huaweicloud.com/api-isdp/api_01_0135.html)  | 调用该接口获取设备编号和isdp唯一设备ID。 AI检测异步回调时，需要输入设备编号；当msgType为device_alarm时，需要输入isdp唯一设备ID。 |
   
#### 调用流程
图1AI检测异步回调流程   
![](https://support.huaweicloud.com/api-isdp/zh-cn_image_0000002522854579.png "点击放大")
#### 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](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的access_token的值 |
   
#### 请求参数
| **参数**      | **类型** | **是否必填** | **描述**                                                                                                                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|
| msgId       | String | 是        | 消息ID                                                                                                                                                                                                                                                                                                                                                                                                                           |
| deviceId    | String | 是        | 设备编号 获取设备编号API请参见：[摄像头列表查询（好望云平台）（API名称：getDeviceList）](https://support.huaweicloud.com/api-isdp/api_01_0135.html)                                                                                                                                                                                                                                                    |
| 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）](https://support.huaweicloud.com/api-isdp/api_01_0135.html) |
| 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
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。
#### 错误码
错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。
