文档首页/ 行业视频管理服务 IVM/ API参考/ 目标库接口/ 按索引范围获取目标信息列表
更新时间：2024-05-21 GMT+08:00
查看PDF
分享

按索引范围获取目标信息列表

功能介绍

按索引范围获取目标信息列表，仅支持好望协议设备，使用该接口需要设备安装了目标算法，NVR800需要切换到人卡模式，SDC直连需要开启目标库对比

URI

GET /v1/{user_id}/targets

表1 路径参数

参数

是否必选

参数类型

描述

user_id

是

String

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

参数

是否必选

参数类型

描述

count

否

Integer

查询个数：取值范围[1,5000]，不填默认值为10

device_id

是

String

设备ID：

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

group_id

是

Integer

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

start

否

Integer

开始页：取值范围[0,5000]，不填默认值为0

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

Access-Token

是

String

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

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

device_id

String

设备ID：设备唯一标识符

targets

Array of TargetVo objects

目标信息列表（SDC不返回图片）
表5 TargetVo

参数

参数类型

描述

target_id

String

目标ID：目标标识符

name

String

姓名

gender

String

性别

age

Integer

年龄

country

String

国家

nation

String

民族

native

String

籍贯

occupation

String

职业

organization

String

组织名称

work_no

String

工号或身份证号

phone

String

电话

email

String

email

domicile

String

居住地

remark

String

备注

eigen_value

String

图片特征值

jpg

String

图片内容：经过base64编码

start_time

String

开始时间

end_time

String

结束时间

external_target_id

String

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

请求示例

按索引范围获取目标信息列表

GET /v1/2562572829***/targets?device_id=952352LWXT***&group_id=2

响应示例

状态码： 200

OK

{
  "device_id" : "952352LWXT***",
  "targets" : [ {
    "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...",
    "target_id" : "2",
    "external_target_id" : "1234567890123***"
  } ]
}

状态码

请参见状态码

错误码

请参见错误码

父主题： 目标库接口

相关文档