调用AddMonitor添加一个预警任务,并获取对应的任务ID。获取任务ID后需要通过UpdateMonitor添加实际的预警条件后才会开始预警。

调试

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

请求参数

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

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

AlgorithmVendor String damo

算法厂商,yushi / damo, 非特殊说明,取值 damo

CorpId String 10001

租户ID

MonitorType String face

预警类型,包括人脸(face),人体(body),机动车(motor),非机动车(non-motor)。

Description String 敏感区域进入预警

预警描述

BatchIndicator Integer 0

是否批量预警,非必填项,默认为0

NotifierType String webhook

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

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

用户注册的通知地址

NotifierAppSecret String mySecret

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

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 Struct

返回结果

TaskId String 300f7e67c82e42b48a197894f512343b

预警任务ID

Message String success

返回消息

RequestId String 46329000-489C-4E63-9BA1-C1DA5C5D0980

请求ID

示例

请求示例

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

正常返回示例

JSON格式

{"Message":"success","RequestId":"46329000-489C-4E63-9BA1-C1DA5C5D0980","Data":{"TaskId":"300f7e67c82e42b48a197894f512343b"},"Code":"200"}

错误码

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

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