文档首页> ISDP> API参考> API> 人员管理> 查询指定时间范围人员(API名称:getPersonListByRangeTime)
更新时间:2024-01-18 GMT+08:00
分享

查询指定时间范围人员(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
}

状态码

状态码请参见状态码

错误码

错误码请参见错误码

分享:

    相关文档

    相关产品