# 查询指定时间范围人员（API名称：getPersonListByRangeTime）
#### 功能介绍
该接口用于查询指定时间段内人员信息。
#### 相关API
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 |
   
#### 调用流程
图1查询指定时间范围人员流程   
![](https://support.huaweicloud.com/api-isdp/zh-cn_image_0000002490654804.png "点击放大")
#### URL
| **请求方式** | **HTTPS地址**                                                      | **服务架构** | **消息体类型**        |
|:---|:---|:---|:---|
| POST     | https://***isdp+域名***/openapi/v1/person/getPersonListByRangeTime | OpenAPI  | application/json |
   
#### 请求头
| **KEY**       | VALUE                  | 是否必填 | **描述**                                                                                           |
|:---|:---|:---|:---|
| Content-Type  | application/json       | 是    | 无                                                                                                |
| Authorization | bearer ${access_token} | 是    | bearer +" "+[5.2.1](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的access_token的值 |
   
#### 请求参数
| **参数**              | **类型**  | **是否必填** | **描述**                   |
|:---|:---|:---|:---|
| start               | Integer | 是        | 取数起始下标，从0开始              |
| count               | Integer | 是        | 每页数                      |
| startTime           | String  | 否        | 开始时间：YYYY-MM-DD HH:MI:SS |
| endTime             | String  | 否        | 结束时间：YYYY-MM-DD HH:MI:SS |
| isRemoveSmartDevice | String  | 否        | 是否为智能设备类型：Y/N            |
   
#### 响应参数
| **参数**     | **类型** | **描述**    |
|:---|:---|:---|
| pos        | int    | 分页取数下标    |
| totalCount | int    | 满足条件的总记录数 |
| data       | object | 数据        |
   
data出参：
| **参数**              | **类型** | **描述** |
|:---|:---|:---|
| userId              | Long   | 用户id   |
| personCode          | String | 人员账号   |
| personStatus        | String | 人员状态   |
| personUpdatedStatus | String | 人员更新状态 |
   
#### 请求示例
```
{
    "start"：0,
    "count"：15,
    "startTime"："2022-01-01 12:00:00",
    "endTime"："2022-01-11 12:00:00",
    "isRemoveSmartDevice"："N"
}
```
#### 响应示例
```
{
    "data": [
        {
            "userId": "1000",
            "personCode": "test1",
            "personStatus": "OpenAccount",
            "personUpdatedStatus": "add/update/delelte"
        }
    ],
    "pos": 0,
    "totalCount": 1,
    "entityName": null
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。
#### 错误码
错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。