2.4查询人员列表

2.4.1应用场景

第三方平台根据条件查询人员信息列表。（注：请求频率小于60次/分钟）

2.1.2.请求链接

URL地址：http://服务器地址/api/v2/people/getlist

2.4.3请求参数

字段	类型	长度	必填	描述	示例值
companyno	string	32	是	企业编号	e41e0f04d13e4196
appid	string	32	是	第三方应用appid	123456789
timestamp	string	32	是	时间戳字符串	20200701161800123
sign	string	50	是	签名字符串	同社区接口签名一致
data	string		是	参数，必须是正确的json字符串格式，并且经过AES加密	详情见参数示例
–pageindex	Int	11	是	当前页数	1
–pagesize	Int	11	是	每页显示数量	20
–deptno	String	32	否	部门编号	完整编号，精确查找
–no	String	32	否	人员编号	完整编号，精确查找
–name	String	32	否	人员姓名	关键词，模糊匹配
–phone	String	32	否	手机号码	完整号码，精确查找
–idcard	String	32	否	证件号码	完整号码，精确查找
–iccard	String	32	否	IC卡号	完整号码，精确查找

2.4.4返回结果

字段	类型	描述	示例值
resultcode	string	结果状态	1成功，0失败
msg	string	结果信息
appid	string	第三方应用appid	e41e0f04d13e4196
timestamp	string	时间戳字符串	20200701161800123
sign	string	签名字符串	同社区接口签名一致
data	string	参数，必须是正确的json字符串格式，并且经过 AES加密	详情见参数示例
– total	Int	总数量
– totalPage	int	总页数
– data	string	人员信息列表
– no	string	人员编号
– jobNumber	string	工号
– name	string	姓名
– sex	string	性别	男、女、未知
– phone	string	手机号码
– idCard	string	证件号
– icCard	string	IC卡号
– type	string	名单类型	默认：白名单
– photo	string	人员头像图片	阿里云在线url
– idCardPhoto	string	证件照图片	阿里云在线url
– remark	string	备注
– startDate	string	开始有效期
– effDate	string	结束有效期
– native	string	籍贯
– nation	string	民族
– residence	string	户籍
– deptNo	string	部门编号
– deptName	string	部门名称

返回成功

{
"resultcode":"1",
"msg":"获取列表成功",
"appid":"2201140459374",
"timestamp":"20220330142506052",
"data":"
{"total":56,"totalPage":3,"data":[{"jobNumber":"100676","no":"1744965266261879","name":"张浩","sex":"女","phone":"18126179289","idCard":"","icCard":"1000000189","type":"白名单","photo":"https://arkcloud-test.oss-cn-shenzhen.aliyuncs.com/web/1678238812395982/100676_1.jpg?Expires=4901163684&OSSAccessKeyId=LTAIKypdJuYEjfhe&Signature=RQU%2F0xXi%2FOQOGXAAhEF26HibJCs%3D","idCardPhoto":"","idCardPhoto1":null,"remark":"名单导入","startDate":"2022-02-10 00:00:00","effDate":"2052-02-10 23:59:59","native":"","nation":"","residence":"","deptNo":"1686638553482330","deptName":"研发部"},
{"jobNumber":"100005","no":"1744963654068528","name":"蒋设","sex":"女","phone":"18126179102","idCard":"","icCard":"1167444652","type":"白名单","photo":"https://arkcloud-test.oss-cn-shenzhen.aliyuncs.com/web/1678238812395982/17454900842412223.jpg?Expires=4901163684&OSSAccessKeyId=LTAIKypdJuYEjfhe&Signature=BcQ8qNm22kEI6RxLIM5EbInc4WE%3D&x-oss-process=image%2Fresize%2Cp_50","idCardPhoto":"","idCardPhoto1":null,"remark":"名单导入","startDate":"2022-02-10 00:00:00","effDate":"2052-02-10 23:59:59","native":"","nation":"","residence":"","deptNo":"1682323133409334","deptName":"中试部"}]
}",
"sign":"7cc62da13e3c91bc8b7a07706d6a5243"
}

返回失败

{
"resultcode":"0",
"msg":"获取列表失败",
"appid":"2201140459374",
"timestamp":"20220330142506052",
"data":"",
"sign":"7cc62da13e3c91bc8b7a07706d6a5243"
}

作者：邻好互联创建时间：2025-06-18 18:04
最后编辑：邻好互联更新时间：2025-06-19 17:52