按索引范围获取目标信息列表
功能介绍
按索引范围获取目标信息列表,仅支持好望协议设备,使用该接口需要设备安装了目标算法,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***"
} ]
} 状态码
请参见状态码
错误码
请参见错误码