调用UpdateMonitor初始化预警条件并开启预警,或者对已有的预警任务进行更新。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String UpdateMonitor

系统规定参数。取值:UpdateMonitor。

AlgorithmVendor String damo

任务算子名称 yushi; damo

CorpId String 10001

租户ID

TaskId String d5b65bb43c5242d89b199a360211930c

任务ID,需要通过AddMonitor获取

RuleName String un_mask_match

预警规则名称,支持:黑名单预警

black_image_match,无口罩预警

un_mask_match。

DeviceOperateType String ADD

设备操作类型,分为添加(ADD),删除(DELETE),替换(REPLACE)

DeviceList String 33011012011327990001,33011012011327990002

设备GBID列表,GBID之间用英文逗号(,)分隔。

PicOperateType String ADD

图片操作类型,分为添加(ADD),删除(DELETE),替换(REPLACE)。

PicList String http://xxx/0/4ed87f4f04c14a259f3da12ff46b9125.jpg,http://xxx/0/4ed87f4f04c14a259f3da12ff46b9126.jpg

预警的图片列表,多个图片URL之间通过英文逗号(,)分隔。

AttributeOperateType String ADD

属性操作类型,分为添加(ADD),删除(DELETE),替换(REPLACE)。保留字段,暂时不生效。

AttributeName String PlateNo

可用于预警的属性名称,如车牌号PlateNo。保留字段,暂时不生效。

AttributeValueList String 浙AXXXX

用于预警定义的属性值。保留字段,暂时不生效。

Description String 预警测试

预警描述信息。

RuleExpression String 保留字段

保留字段

NotifierType String webhook

通知类型, 非特殊说明,取值webhook

NotifierUrl String http://oapi.dingtalk.com/robot/send

用户注册的通知地址

NotifierAppSecret String

用户设置的通知秘钥,用于校验通知内容是否被篡改

NotifierTimeOut Integer 2000

通知的超时时间

NotifierExtendValues String {\"userId\": \"1\" }

通知扩展信息,用户如果设置了扩展信息,会附加在发给用户的预警通知中

发送给用户注册的通知地址的预警结果格式

head部分示例

sign=d6bfe3ce1bf5714887f4ffbb7b94feab timestamp=20200904120905

body部分示例

{ "RequestId":"ca2a2942-bcf4-43e3-b1b6-758e2100b588", "WebHookMessages":[ { "extendInfo":{ }, "gbId":"xxx", "leftUpX":"414", "leftUpY":"354", "picUrl":"xxx", "rightBottomX":"876", "rightBottomY":"870", "score":"0.93", "shotTime":"Thu Oct 22 10:53:06 CST 2020", "targetPicUrl":"xxx", "taskId":"xxx" } ] }

头部签名合法验证

拼接,将所有核心发送参数拼接起来, 格式如下

timestamp=20200904120905&data={}&appSecret=sdcqwdqsdcdc

字段之间用【&】进行分割

• 生成签名,将上述拼接的字符串尽心MD5加密后转换成大写

String mysign= DigestUtils.md5DigestAsHex(sb.toString().getBytes()).toUpperCase();

然后对比生成的签名和预警结果头部包含的是否一致,如果一致说明内容未被篡改

返回数据

名称 类型 示例值 描述
Code String 200

返回编码

Data String {"taskId": "d5b65bb43c5242d89b199a360211930c" }

返回结果

Message String success

返回结果消息

RequestId String ff519c35_e070_4da3_a3d0_cfe5c9b4eb74

请求ID

示例

请求示例

http(s)://[Endpoint]/?Action=UpdateMonitor
&AlgorithmVendor=damo
&CorpId=10001
&TaskId=d5b65bb43c5242d89b199a360211930c
&<公共请求参数>

正常返回示例

JSON格式

{"RequestId":"ff519c35_e070_4da3_a3d0_cfe5c9b4eb74","Message":"success","Data":"{\"taskId\": \"d5b65bb43c5242d89b199a360211930c\" }","Code":"200"}

错误码

HttpCode 错误码 错误信息 描述
400 InternalError A system error occurred. 系统错误
401 InvalidCorpIdError The specified CorpId is invalid. 无效的项目码

访问错误中心查看更多错误码。