查询员工id
接口说明: 通过手机号,邮箱,工号等来查询员工id
请求方式:POST(HTTPS)
请求地址:https://api.xinrenxinshi.com/v5/employee/getId
请求Header:
key | value |
---|---|
access_token | 获取的access_token的实际值 |
Query参数:
key | value |
---|---|
sign | 签名值 |
Body参数:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
type | String | Y | 参数类型,0-手机号,1-工作邮箱,2-工号,例如选0类型,则只能用mobiles列表进行查询 |
mobiles | List<String> | N | 要查询的员工手机号,最多100条 |
emails | List<String> | N | 要查询的员工工作邮箱,最多100条 |
jobNumbers | List<String> | N | 要查询的员工工号,最多100条 |
status | Integer | N | 默认是在职状态,0-在职,1-离职,2-待入职 |
timestamp | Long | Y | 请求时间戳(精确到毫秒) |
返回结果:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
errcode | Integer | Y | 错误码 |
errmsg | String | Y | 错误信息 |
data | Map<String,String> | Y | 响应数据, 参数值-员工id (没有查到对应员工id的不会返回) |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/employee/getId?sign=X5O4br3gDtG1wMwSnWCkWe%2BXIgQ%3D
请求Body示例:
{
"type": "0",
"mobiles": ["19423442345","19400234234"],
"status": 0,
"timestamp": 1606198702442
}
{
"type": "1",
"emails": ["a@qq.com","b@qq.com"],
"status": 0,
"timestamp": 1606198702442
}
{
"type": "2",
"jobNumbers": ["001","002"],
"status": 0,
"timestamp": 1606198702442
}
SDK请求示例(java):
EmployeeGetIdRequest request = new EmployeeGetIdRequest(access_token());
request.setEmails(Arrays.asList("d@qq.com"));
request.setType("1");
OpenapiResponse<Map<String,String>> list = XrxsEmployeeService.getEmployeeId(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": {
"19423442345": "3cb890a315fa4d2fa9b2bcae3e885312"
}
}