更新时间:2024-05-21 GMT+08:00
分享

新增目标库分组

功能介绍

新增目标库分组,仅支持好望协议设备,使用该接口需要设备安装了目标算法,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"
}

状态码

请参见状态码

错误码

请参见错误码

相关文档