# 获取目标信息
#### 功能介绍
获取目标信息，仅支持好望协议设备，IVS1800不支持，使用该接口需要设备安装了目标算法，NVR800需要切换到人卡模式，SDC直连需要开启目标库对比
#### URI
POST /v1/{user_id}/targets
表1路径参数 
| 参数      | 是否必选 | 参数类型   | 描述                                                                                                                                                              |
|:---|:---|:---|:---|
| user_id | 是    | String | 用户ID：由数字组成，长度范围\[15,25\]，获取方式参考[获取user ID与下载AK/SK](https://support.huaweicloud.com/api-ivm/ivm_03_0005.html#ZH-CN_TOPIC_0000001710465704__section1213543912215) |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                    |
|:---|:---|:---|:---|
| Access-Token | 是    | String | 用户认证AccessToken：从[获取用户北向接口认证AccessToken](https://support.huaweicloud.com/api-ivm/ivm_03_0002.html)中获取 |
   
表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列表](https://support.huaweicloud.com/api-ivm/ivm_03_0111.html)、[获取目标信息](https://support.huaweicloud.com/api-ivm/ivm_03_0110.html)、[按索引范围获取目标ID信息](https://support.huaweicloud.com/api-ivm/ivm_03_0122.html)中获取 |
   
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数      | 参数类型                                                                          | 描述                         |
|:---|:---|:---|
| targets | Array of [TargetVo] objects | 目标列表（SDC仅返回图片信息和用户传入的目标ID） |
   
 表5TargetVo 
| 参数                 | 参数类型    | 描述                                                                                         |
|:---|:---|:---|
| 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：用户自定义的，在[添加目标](https://support.huaweicloud.com/api-ivm/ivm_03_0113.html)的时候由客户填入 |
   
#### 请求示例
获取目标
```
POST /v1/2562572829***/targets
{
  "device_id" : "952352LWXT***",
  "target_ids" : [ "2" ]
}
```
#### 响应示例
**状态码： 200**
OK
```
{
  "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"
}
```
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-ivm/ivm_03_0136.html)
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ivm/ivm_03_0137.html)