获取员工免登url
接口说明: 客户通过员工id免密登录到薪人薪事系统。目前支持登录到管理员或员工PC端以及员工的H5端系统。同时也支持免登跳转到指定功能页。
请求方式:POST（HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/login/geturl
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| employeeId | String | Y | 员工id |
| redirectType | Integer | Y | 跳转类型 0:PC端，1:H5端 |
| userType | Integer | N | 默认0，用户类型，0:员工免登，1:管理员免登，2:管理员优先免登 (管理员免登需要单独申请权限) |
| redirectUrlType | Integer | N | 跳转页面类型，默认跳转首页,具体参数详见跳转类型 |
| redirectParam | Map<String,String> | N | 免登跳转相关参数，具体参数详见跳转参数 |
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
特殊说明:
1、免登的url只能使用一次，有效期为30分钟
2、免登跳转到指定页面，目前支持员工免登。即:参数redirectUrlType、redirectParam只有当userType为0时有效；参数redirectUrlType、redirectParam不传时，免登到首页。
3、参数 redirectUrlType 、redirectParam 具体规则如下
当跳转类型redirectType=0，即跳转到PC端的时候，redirectUrlType以及redirectParam对应的参数如下| PC端免登 | ||
|---|---|---|
| redirectUrlType | redirectParam | 说明 |
| 0 | 无需跳转参数 | 首页 |
| 1 | {"processId":"700284793459314689"} processId为审批id |
跳转到员工系统PC端审批详情页面(无编辑权限) |
| 2 | {"processId":"700284793459314689"} processId为审批id |
跳转到员工系统PC端审批详情页面(有编辑权限) |
| 3 | 无需跳转参数 | 跳转到员工系统PC端我的绩效页面 |
| 4 | 无需跳转参数 | 跳转到员工系统pc端审批列表页面 |
| 5 | 无需跳转参数 | 跳转到员工系统pc端工资条页面 |
| 6 | 无需跳转参数 | 跳转到员工系统pc端考勤确认页面 |
| 7 | 无需跳转参数 | 跳转到员工系统pc端招聘页面 |
| 8 | 无需跳转参数 | 跳转到员工系统pc端公告列表页面 |
| 9 | 无需跳转参数 | 跳转到员工系统pc端电子合同页面 |
| 10 | 无需跳转参数 | 跳转到员工系统pc端申请首页 |
| 11 | {"url":"https://ip:port/"} url为跳转的页面地址 |
跳转到指定的url,只支持部分消息通知的页面免登 |
| H5端免登 | ||
|---|---|---|
| redirectUrlType | redirectParam | 说明 |
| 0 | 无需跳转参数 | 首页 |
| 1 | 无需跳转参数 | 审批列表 |
| 2 | 无需跳转参数 | 工资条列表 |
| 3 | 无需跳转参数 | 考勤列表 |
| 4 | 无需跳转参数 | 招聘列表 |
| 5 | 无需跳转参数 | 内容推荐 |
| 6 | 无需跳转参数 | 公告列表 |
| 7 | 无需跳转参数 | 我的团队 |
| 8 | 无需跳转参数 | 申请首页 |
| 9 | {"id":"700284793459314689"} id为审批id |
发起人的审批详情页面 |
| 10 | {"id":"700284793459314689"} id为审批id |
审批人或抄送人的审批详情页面 |
| 11 | 无需跳转参数 | 请假功能页 |
| 12 | {"url":"https://ip:port/"} url为跳转的页面地址 |
跳转到指定的url |
| 13 | 无需跳转参数 | 我的绩效 |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 0成功，其他失败 |
| errmsg | String | Y | 操作结果描述 |
| data | String | Y | 免登的url地址 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/login/geturl?sign=231SDSFDFWdewd12313
请求正文:
{
"employeeId":"31f5664bbc9648deb3df6410df14b648",
"userType":2,
"redirectType":0,
"timestamp":1607052911001
}
请求样式(SDK):
String access_token = access_token();
FreeLoginRequest request = new FreeLoginRequest(access_token);
request.setEmployeeId("31f5664bbc9648deb3df6410df14b648");
request.setRedirectType(ERedirectTypeEnum.PC.getLoginType());
request.setUserType(EUserTypeEnum.ADMIN_FIRST.getUserType());
OpenapiResponse<String> freeLoginUrl = XrxsFreeLoginService.getFreeLoginUrl(request);
响应示例:
{
"errcode":0,
"errmsg":"成功",
"data":"https://s.xinrenxinshi.com/account-center/sso/free-login?token=TOKEN"
}