openplatform

免登流程

JSSDK 更新于 2026-08-28 阅读 17

获取免登授权码

“免登”是指用户进入应用后,无需输入蓝信用户名和密码,应用程序可自动获取当前用户身份,进而登录系统的流程。

调用该接口前需要保证当前网页 url 符合可信域名中配置

蓝信版本: ios: >6.6.85 android: >6.6.88 windows: >6.6.110 mac: >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 接口安全域名校验失败

获取到免登授权码之后,调用应用服务端接口,可获取当前登录人信息

服务端可依次调用以下接口

  1. 获取应用访问 TOKEN: appId + appSecret = appToken
  2. 获取人员访问 TOKEN: appToken + code = userToken
  3. 获取人员基本信息: appToken + userToken = userInfo