查询指定时间范围人员(API名称:getPersonListByRangeTime)
功能介绍
该接口用于查询指定时间段内人员信息。
相关API
| 接口名称 | 调用说明 |
|---|---|
| 调用该接口获取到Token,再调用其他接口时,需要在请求消息头中添加“Authorization”,其值即为Token。 |
调用流程
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中获取的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
} 状态码
状态码请参见状态码。
错误码
错误码请参见错误码。