按索引范围获取目标信息列表
功能介绍
按索引范围获取目标信息列表，仅支持好望协议设备，使用该接口需要设备安装了目标算法，NVR800需要切换到人卡模式，SDC直连需要开启目标库对比
URI
GET /v1/{user_id}/targets
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
user_id |
是 |
String |
用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
count |
否 |
Integer |
查询个数：取值范围[1,5000]，不填默认值为10 |
|
device_id |
是 |
String |
设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 |
|
group_id |
是 |
Integer |
目标库分组ID：非负值，从获取目标库分组接口获取 |
|
start |
否 |
Integer |
开始页：取值范围[0,5000]，不填默认值为0 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Access-Token |
是 |
String |
用户认证AccessToken：从获取用户北向接口认证AccessToken中获取 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
device_id |
String |
设备ID：设备唯一标识符 |
|
targets |
Array of TargetVo objects |
目标信息列表（SDC不返回图片） |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
电话 |
|
|
String |
|
|
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***"
} ]
}
状态码
请参见状态码
错误码
请参见错误码
