免登流程
获取免登授权码
“免登”是指用户进入应用后,无需输入蓝信用户名和密码,应用程序可自动获取当前用户身份,进而登录系统的流程。
调用该接口前需要保证当前网页 url 符合可信域名中配置
蓝信版本:
ios: >6.6.85android: >6.6.88windows: >6.6.110mac: >6.6.202
使用以下代码获取免登授权码(调用此 api 不需要进行鉴权,即不需要 lx.config)。获取的免登授权码有效期 5 分钟,且只能使用一次
示例代码
lx.biz.getAuthCode({
appId: "String",
success: function (res) {
/**
{
authCode: 'String' //获取的免登授权码有效期5分钟,且只能使用一次,用于换取Token(如提供给服务端)
}
*/
},
fail: function (err) {},
});
参数说明
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| appId | String | 是 | 应用 id |
SUCCESS 返回值说明
| 字段 | 类型 | 说明 |
|---|---|---|
| authCode | String | 免登授权码,只能使用一次,用于换取 Token(如提供给服务端) |
errorCode 说明
| code 值 | message 值 | 说明 |
|---|---|---|
| 50061 | GET_AUTH_CODE_FAILED | 获取 authCode 失败,失败原因:; 1. appId 不存在; 2. 应用 JS 接口安全域名校验失败 |
获取到免登授权码之后,调用应用服务端接口,可获取当前登录人信息
服务端可依次调用以下接口
- 获取应用访问 TOKEN: appId + appSecret = appToken
- 获取人员访问 TOKEN: appToken + code = userToken
- 获取人员基本信息: appToken + userToken = userInfo