文档首页/ ISDP/ API参考/ API接口/ 人员管理/ 查询指定时间范围人员（API名称：getPersonListByRangeTime）
更新时间：2024-01-18 GMT+08:00
查看PDF
分享

查询指定时间范围人员（API名称：getPersonListByRangeTime）

功能介绍

该接口用于查询指定时间段内人员信息。

相关API

接口名称

调用说明

获取Token

调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。

调用流程

图1 查询指定时间范围人员流程

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
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 人员管理

相关文档