注册摄像头信息变化通知接口
更新时间:2023-11-22
接口描述
添加接收摄像头相关信息的URL地址。
说明:允许重复注册,比如调用者每次重启时调用一次,这样就可以重新接受数据推送。目前只支持http://格式的url,尚不支持https。 在以下情况会主动推送:
1、接收方调用该接口注册后,会主动推送。
2、如果某次推送失败,会在30秒后重试。
3、后端进程重启时会主动推送一次。
4、摄像头信息变更时(比如摄像头离线、更新摄像头绑定算法任务等)会主动推送。
请求结构
POST /console/api/v1/set-notify-url
请求头域
请求头名称 | 描述 | 示例 |
---|---|---|
Authorization | 认证头。登录响应返回的token内容,如果不填或者填错会拒绝请求 | 如果不想走登录认证获取token,也可以联系值班人员获取Authorization内容,内容格式为字母编码:xxxxx |
请求参数
参数 | 类型 | 是否必选 | 描述 | 示例 |
---|---|---|---|---|
url | String | 是 | 接收摄像头设备配置相关数据的http://ip:port/xxx形式的URL地址。未来可能支持https形式。 | url是类似http://a.b.c.d:4423/recv 这种http接收地址 |
type | String | 是 | 接受何种信息的变更通知。当前可选值只有"device", 包括设备名称、流地址、绑定算法信息 | type目前固定为device |
响应头域
无特殊响应头。
响应参数
参数 | 类型 | 描述 |
---|---|---|
status | Int32 | 接口返回状态, 0表示成功,其他表示失败 |
message | String | success, 或者失败原因 |
data | JSON | 暂无数据,可以忽略该字段 |
响应错误码参数
错误码 | 含义 |
---|---|
10000 | 请求参数无效;比如非JSON请求,或者url无效等。 |
10004 | 更新数据库失败。 |
请求示例
{
"type": "device",
"url": "http://a.b.c.d:1234/recv/test"
}
响应示例
{
"status": 0,
"message": "success",
"data": null
}