文档首页/行业视频管理服务 IVM/API参考/目标库接口/新增目标库分组
更新时间：2024-05-21 GMT+08:00
查看PDF
分享

新增目标库分组

功能介绍

新增目标库分组，仅支持好望协议设备，使用该接口需要设备安装了目标算法，NVR800需要切换到人卡模式，SDC直连需要开启目标库对比

接口约束

1.目标库数量不可超过目标库分组最大规格限制，即获取目标库分组接口的响应参数的group_max_count字段

2.IVS1800或SDC直连同一台设备的目标库分组不可重名

URI

POST /v1/{user_id}/target-groups

表1 路径参数

参数

是否必选

参数类型

描述

user_id

是

String

用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Access-Token

是

String

用户认证AccessToken：从获取用户北向接口认证AccessToken中获取

表3 请求Body参数

参数

是否必选

参数类型

描述

group_name

是

String

目标库分组名称：最大为63位

device_id

是

String

设备ID：

好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取

group_type

否

String

目标库分组类型：枚举类型，不同设备支持的枚举类型不一样

NVR800设备下的目标库分组类型：不填默认为白名单

枚举值：

  • WHITE 白名单

  • STRANGE 陌生人

  • BLACK 黑名单

SDC设备下的目标库分组类型：不填默认为其他名单

枚举值：

  • OTHER 其他名单

  • DEFAULT 默认名单

  • WHITE 白名单

IVS1800设备下的目标库分组类型：不填默认为白名单

枚举值：

  • WHITE 白名单

  • STRANGE 陌生人

  • RED 红名单

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

device_id

String

设备ID：设备唯一标识符

group_id

String

目标库分组ID：目标库标识符

请求示例

SDC新增名为ssred的目标库

POST /v1/2562572829***/target-groups

{
  "group_name" : "ssred",
  "group_type" : "OTHER",
  "device_id" : "952352LWXT***"
}

响应示例

状态码： 200

OK

{
  "device_id" : "952352LWXT***",
  "group_id" : "4"
}

状态码

请参见状态码

错误码

请参见错误码

父主题：目标库接口

相关文档