1、根据条件查询人员列表
1.1、应用场景
第三方平台根据条件查询人员信息列表。(注:请求频率小于60次/分钟)
1.2、接口链接
URL地址:http://服务器地址/api/open/People/GetPeopleList
1.3、请求参数
字段 | 类型 | 长度 | 必填 | 描述 | 示例值 |
---|---|---|---|---|---|
appId | string | 32 | 是 | 平台应用appid | pm65b0195c12225a37 |
companyNo | string | 32 | 是 | 企业编码 | 2005181057489971 |
timesTamp | string | 32 | 是 | 时间戳字符串 | 20200701161800123 |
sign | string | 50 | 是 | 签名字符串 | 详情见签名介绍 |
data | string | 是 | 必须是正确的json字符串格式,数据AES加密处理 | 详情见参数示例 | |
– pageIndex | string | 是 | 当前页数 | 默认1 | |
– pageSize | string | 是 | 每页显示数量 | 默认20,最大50 | |
– deptNo | string | 100 | 否 | 部门编号 | |
– no | string | 100 | 否 | 人员编号 | |
– name | string | 50 | 否 | 人员名称 | |
– phone | string | 32 | 否 | 完整手机号 | |
– idCard | string | 100 | 否 | 完整证件号 | |
– icCard | string | 100 | 否 | Ic卡号 |
1.4、参数示例
{
"appId": "pm65b0195c12225a37",
"companyNo": "2006152039393448",
"data": "{“deptNo”:””}", //部门编号
"sign": "",
"timesTamp": "20190109140653904"
}
1.5、响应参数
字段 | 类型 | 长度 | 必填 | 描述 | 示例值 |
---|---|---|---|---|---|
resultCode | string | 是 | 1-请求成功,其他-请求失败 | 1 | |
appId | string | 32 | 是 | 平台应用appid | pm65b0195c12225a37 |
msg | string | 请求失败时返回的消息 | |||
data | string | 响应参数数据包,正确的json字符串格式 | |||
– count | string | 总页数 | |||
–data | string | 内容集合 | |||
—- jobNumber | string | 工号 | |||
—- no | string | 人员编号 | |||
—- name | string | 人员名称 | |||
—- sex | string | 人员性别 | |||
—- phone | string | 人员手机号 | |||
—- idCard | string | 证件号 | |||
—- icCard | string | IC卡号 | |||
—- birth | string | 出生日期 | |||
—- type | string | 人员类型 | |||
—- photo | string | 照片 | |||
—- idCardPhoto | string | 证件照正面 | |||
—- idCardPhoto1 | string | 证件照反面 | |||
—- remark | string | 备注 | |||
—- startDate | string | 有效期开始 | yyyy-MM-dd HH:mm:ss | ||
—- effDate | string | 有效期结束 | yyyy-MM-dd HH:mm:ss | ||
—- native | string | 籍贯 | |||
—- nation | string | 民族 | |||
—- residence | string | 户籍 | |||
—-deptNo | string | 部门编号 | |||
—-deptName | string | 部门名称 |
1.6、请求成功响应参数示例
{
"resultCode": "1", //1:成功,其它:失败
"appId": "1", //应用ID
"data": "{"total":"10","data":"[{
"jobNumber":"",//工号
"no":"",//人员编号
"name":"",//名称
}]"}", //data数据加密处理,详情请看AES加密
"msg": "查询成功"
}
1.7、请求失败响应参数示例
{
"resultCode": "0",
"appId": "pm65b0195c12225a37",
"data": "",
"msg": "查询异常"
}
作者:ppt 创建时间:2024-10-29 19:34
最后编辑:ppt 更新时间:2024-10-30 10:52
最后编辑:ppt 更新时间:2024-10-30 10:52