查询人员列表
1. 应用场景
第三方平台根据条件查询人员信息列表。(注:请求频率小于60次/分钟)
2. 请求链接
http://IP:Port/openapi/people/getlist
3. 请求参数
字段 | 类型 | 长度 | 必填 | 描述 | 示例值 |
---|---|---|---|---|---|
companyno | string | 32 | 是 | 企业编号 | e41e0f04d13e4196 |
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卡号 | 完整号码,精确查找 |
4. 返回结果
字段 | 类型 | 描述 | 示例值 |
---|---|---|---|
resultcode | string | 结果状态 | 1成功,0失败 |
msg | string | 结果信息 | |
companyno | string | 企业编号 | 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 | 部门名称 |
4.1. 返回成功
{
"resultcode": "1",
"msg": "获取列表成功",
"companyno":"2201140459374",
"timestamp": "20220330142506052",
"data": "{
"total": 56,
"totalPage": 3,
"data": [
{
"jobNumber": "100676",
"no": "1744965266261879",
"name": "张*",
"sex": "女",
"phone": "18126179289",
"idCard": "",
"icCard": "1000000189",
"type": "白名单",
"photo": "",
"idCardPhoto": "",
"idCardPhoto1": null,
"remark": "名单导入",
"startDate": "2022-02-10 00:00:00",
"effDate": "2052-02-10 23:59:59",
"native": "",
"nation": "",
"residence": "",
"deptNo": "1686638553482330",
"deptName": "研发部"
}
]
}",
"sign": "7cc62da13e3c91bc8b7a07706d6a5243"
}
4.2. 返回失败
{
"resultcode":"0",
"msg":"获取列表失败",
"companyno":"2201140459374",
"timestamp":"20220330142506052",
"data":"",
"sign":"7cc62da13e3c91bc8b7a07706d6a5243"
}
作者:邻好互联 创建时间:2025-06-18 18:04
最后编辑:mry 更新时间:2025-07-24 18:12
最后编辑:mry 更新时间:2025-07-24 18:12