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

获取目标信息

功能介绍

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

URI

POST /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页面上获取
target_ids	是	Array of strings	目标ID列表：数组长度范围[1,100] 目标ID：支持数字和-，长度范围[1,20]，SDC的目标ID需要带上目标库ID（目标库ID_目标ID的形式），可以从按索引范围获取目标ID列表、获取目标信息、按索引范围获取目标ID信息中获取

响应参数

状态码： 200

表4 响应Body参数
参数	参数类型	描述
targets	Array of TargetVo objects	目标列表（SDC仅返回图片信息和用户传入的目标ID）

表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：用户自定义的，在添加目标的时候由客户填入

请求示例

获取目标

POST /v1/2562572829***/targets

{
  "device_id" : "952352LWXT***",
  "target_ids" : [ "2" ]
}

响应示例

状态码： 200

{
  "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" : "1234567890123456"
}