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

批量修改目标信息

功能介绍

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

URI

PUT /v1/{user_id}/targets

表1 路径参数

参数

是否必选

参数类型

描述

user_id

是

String

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

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Access-Token

是

String

用户认证AccessToken：从获取用户北向接口认证AccessToken中获取
表3 请求Body参数

参数

是否必选

参数类型

描述

device_id

是

String

设备ID：

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

group_id

是

Integer

目标库分组ID：非负值，从获取目标库分组接口获取

targets

是

TargetDto object

目标数据列表：

NVR800和IVS1800：9.1以上版本支持该接口，支持批量修改，最多支持修改20个目标，NVR800的所有图片合计最大为700K，NVR800在脱敏库中目标无法进行修改

SDC：仅支持单目标修改

storage

否

Boolean

是否保存图片：false-不保存图片，true-保存图片，默认值true，NVR800的不保存图片就会保存到脱敏名单库中，SDC和NVR800修改时改字段不生效
表4 TargetDto

参数

是否必选

参数类型

描述

target_id

是

String

目标ID：支持数字和-，长度范围[1,20]，需要已添加目标才可以修改，可以从按索引范围获取目标ID列表、获取目标信息、按索引范围获取目标ID信息中获取

name

是

String

姓名：支持中英文、数字、特殊字符（_-空格），长度范围[1,128]

gender

是

String

性别：枚举类型

枚举值：

  • male 男性

  • female 女性

age

否

Integer

年龄：取值范围[1,255]（仅NVR800支持）

country

否

String

国家：支持大小写字母数字，长度范围[1,128]（SDC不支持）

nation

否

String

民族：支持大小写字母数字，长度范围[1,32]（暂不支持）

native

否

String

籍贯：支持大小写字母数字，长度范围[1,128]（IVS1800不支持）

occupation

否

String

职业：支持大小写字母数字，长度范围[1,128]（SDC不支持）

work_no

否

String

工号或身份证号之类：支持大小写数字，长度范围[1,64]

phone

否

String

电话：11位纯数字（仅NVR800支持）

email

否

String

邮箱：邮箱格式，***@.***（仅NVR800支持）

remark

否

String

备注信息：支持大小写字母数字，长度范围[1,512]（SDC不支持）

jpegBase64

是

String

目标图片：经过base64编码（单个图片建议不超过50K），支持png、jpeg、jpg格式

domicile

否

String

居住地：支持大小写字母数字，长度范围[1,256]（IVS1800不支持）

响应参数

状态码： 200

表5 响应Body参数

参数

参数类型

描述

group_id

Integer

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

target_ids

Array of TargetResultVo objects

目标ID列表
表6 TargetResultVo

参数

参数类型

描述

target_id

String

目标ID：目标标识符

result

Result object

结果信息

external_target_id

String

用户传入的目标ID：用户自定义的，在添加目标的时候由客户填入
表7 Result

参数

参数类型

描述

code

String

错误编码

msg

String

错误信息

请求示例

批量修改目标信息

PUT /v1/2562572829***/targets

{
	"device_id":"952352LWXT***",
	"group_id":2,
	"targets":[
		{
                        "target_id":"2",
			"name":"mark",
			"gender":"male",
			"age":24,
			"country":"中国",
			"nation":"汉",
			"native":"杭州",
			"occupation":"工人",
			"work_no":"124****77",
			"phone":"15********61",
			"email":"1*********@qq.com",
			"domicile":"杭州",
			"remark":"无",
                         "jpegBase64":"/9j/4AAQSkZJRgABAQAAAQABAAD..."}]
}

响应示例

状态码： 200

OK

{
  "group_id" : 2,
  "target_ids" : [ {
    "result" : {
      "code" : "IVM.0",
      "msg" : "Success"
    },
    "target_id" : "2",
    "external_target_id" : "1234567890123456"
  } ]
}

状态码

请参见状态码

错误码

请参见错误码

父主题： 目标库接口

相关文档