首页 > 开发指南 > 通讯录管理
增量查询员工列表
更新时间: 2021-12-08 11:37:24

根据时间段分页查询修改的员工列表

请求说明

请求方式:post+application/json 方式

请求路径:https://open.71360.com/cgi/user/get/batchByUpdTime

参数说明

参数参数类型必须说明
corpAccessTokenString企业应用访问公司合法性凭证
corpIdString开放平台公司帐号
startTimeLong开始时间戳,选填,可为空,为空时不作为条件 ,以毫秒为单位
endTimeLong结束时间戳,选填,可为空,为空时不作为条件 ,以毫秒为单位(endTime必须大于startTime)
pageSizeint每页个数,选填,可为空,为空时默认20,最大为1000,必须为大于0整数
pageNumberint页码,选填,可为空,为空时默认1,必须为大于0整数
showDepartmentIdsDetailboolean如果为true,则会返回员工主属部门(mainDepartmentId)与附属部门(attachingDepartmentIds)


请求包结构体示例:


{
    "corpAccessToken":"CORP_ACCESS_TOKEN",
    "corpId":"CORP_ID",
    "pageSize":20,
    "pageNumber":1,
    "startTime":1462519137700,
    "endTime":1462519137705
}

返回说明


参数必须说明
errorCode返回码
errorMessage对返回码的文本描述内容
pageNumber当前页码
pageCount每页个数
totalCount员工总数
lastChangedTime查询结果中的最后更新时间时间戳
employees二级对象,员工列表
openUserId开放平台员工帐号
account员工账号
name员工姓名
nickName员工昵称
isStop员工状态,如果为true,则表示此员工离职,否则,该员工状态为在职
email邮箱
mobile手机号
gender员工性别:M(男) F(女)
position员工职位
profileImageUrl头像文件Url, 注: 后缀.jpg 前的数字表示图像尺寸大小: 1 表示150150, 2表示5050, 3表示30*30
departmentIds员工所属部门及其父部门ID列表
mainDepartmentId员工主属部门ID
attachingDepartmentIds员工附属部门ID列表
qqQQ号码
weixin微信号


a)正确的Json返回结果示例:


{
    "employees": [
        {
            "openUserId": "FSUID_31AF1CA2167F216A0E6A7D4CB2CC7F21",
            "name": "zyx-fmeceshitt",
            "nickName": "zyx-ceshitt",
            "isStop": false,
            "email": "xxx@71360.com",
            "mobile": "13688286358",
            "gender": "M",
            "position": "经理",
            "departmentIds": []
        },
        {
            "openUserId": "FSUID_008A0B77D4BC392B8C8C9F3F6EEB244D",
            "account": "18605508888",
            "name": "zyzyzy",
            "nickName": "zyzyzy",
            "isStop": false,
            "mobile": "18605508888",
            "gender": "M",
            "departmentIds": []
        }
    ],
    "pageNumber": 1,
    "pageCount": 20,
    "totalCount": 2,
    "lastChangedTime": 1462776430797,
    "errorCode": 0,
    "errorMessage": "success"
}

b)错误的Json返回示例:


{
    "errorCode": 10043,
    "errorMessage": "the parameter pagesize is to large"
}