Authing 文档文档
快速开始
概念
使用指南
开发集成 V2 arrow
  • V2 文档
  • V3 文档
元数据
应用集成
身份自动化
加入 APN
开发集成
多租户(内测版)
控制台文档
多租户控制台
租户控制台
Saas 应用 Demo
快速开始
概念
使用指南
开发集成 V2 arrow
  • V2 文档
  • V3 文档
元数据
应用集成
身份自动化
加入 APN
开发集成
多租户(内测版)
控制台文档
多租户控制台
租户控制台
Saas 应用 Demo
旧版
开发集成
  • JavaScript SDK 索引
  • 单点登录(SSO)
  • 登录组件 (Guard)

  • 多因素认证组件(MFA)

  • JavaScript / Node.js

  • Java / Kotlin

  • Python

  • C#

  • PHP

  • Go

  • Ruby
  • Delphi
  • Android

    • 快速开始
    • 托管页
    • 超组件

    • APIs

      • 核心认证 API
      • 标准协议 API
      • 多因素认证 API
      • 扫码认证 API
      • 设备管理 API
      • 事件订阅 API
    • 第三方身份源

    • 典型场景

    • 私有化部署
    • Android Guard 更新日志
    • 合规使用指南
    • 返回码对照表
  • iOS

  • Flutter

  • 微信小程序
  • 微信网页授权
  • React Native
  • 框架集成

  • Radius
  • 错误代码

¶ 核心认证 API

更新时间: 2025-06-11 08:01:00
编辑

¶ 邮箱注册

使用邮箱注册帐号,邮箱不区分大小写且用户池内唯一。此接口不要求用户对邮箱进行验证,用户注册之后 emailVerified 字段会为 false 。

public static void registerByEmail(String email, String password, String context, @NotNull AuthCallback<UserInfo> callback)

参数

  • email 邮箱
  • password 明文密码
  • context 请求上下文,这里设置的 context 可以在 pipeline 的 context (opens new window) 中获取到,如不需要可传 null。

示例

JSONObject context = new JSONObject();
context.put("userId", "userId");
AuthClient.registerByEmail("test@example.com", "xxxxxx", context.toString(), (code, message, userInfo)->{
    if (code == 200) {
        // userInfo:用户信息
    }
});

错误码

  • 2003 非法邮箱地址
  • 2026 邮箱已注册

¶ 邮箱验证码注册

使用邮箱验证码注册帐号,邮箱不区分大小写且用户池内唯一。此接口不要求用户对邮箱进行验证,用户注册之后 emailVerified 字段会为 false,需要先调用 发送邮件 接口(场景值为 VERIFY_CODE)。

public static void registerByEmailCode(String email, String code, String context, @NotNull AuthCallback<UserInfo> callback)

参数

  • email 邮箱
  • code 验证码
  • context 请求上下文,这里设置的 context 可以在 pipeline 的 context (opens new window) 中获取到,如不需要可传 null。

示例

JSONObject context = new JSONObject();
context.put("userId", "userId");
AuthClient.registerByEmailCode("test@example.com", "1234", context.toString(), (code, message, userInfo)->{
    if (code == 200) {
        // userInfo:用户信息
    }
});

错误码

  • 2003 非法邮箱地址
  • 2026 邮箱已注册

¶ 用户名注册

通过用户名注册帐号。用户名区分大小写且用户池内唯一。

public static void registerByUserName(String username, String password, String context, @NotNull AuthCallback<UserInfo> callback)

参数

  • username 用户名
  • password 明文密码
  • context 请求上下文,这里设置的 context 可以在 pipeline 的 context (opens new window) 中获取到,如不需要可传 null。

示例

JSONObject context = new JSONObject();
context.put("userId", "userId");
AuthClient.registerByUserName("test", "xxxxxx", context.toString(), (code, message, userInfo)->{
    if (code == 200) {
        // userInfo:用户信息
    }
});

错误码

  • 2026 用户名已存在

¶ 短信验证码注册

通过手机号和短信验证码注册帐号。手机号需要在用户池内唯一。调用此接口之前,需要先调用 发送短信验证码 接口以获取短信验证码

public static void registerByPhoneCode(String phoneCountryCode, String phone, String code, String password, String context, @NotNull AuthCallback<UserInfo> callback)

参数

  • phoneCountryCode 电话国家码。可以为空,为空时默认为 +86
  • phone 手机号
  • code 短信验证码
  • password 明文密码,如果没有可传 “” 或者 null
  • context 请求上下文,这里设置的 context 可以在 pipeline 的 context (opens new window) 中获取到,如不需要可传 null。

示例

JSONObject context = new JSONObject();
context.put("userId", "userId");
AuthClient.registerByPhoneCode("+86", "188xxxx8888", "1234", "xxxxxx", context.toString(), (code, message, userInfo)->{
    if (code == 200) {
        // userInfo:用户信息
    }
});

错误码

  • 2001 验证码错误
  • 2026 手机号已注册

¶ 自定义字段注册

使用自定义字段注册的账号,可直接使用账号密码登录。

public static void registerByExtendField(String fieldName, String account, String password, String context, @NotNull AuthCallback<UserInfo> callback)

参数

  • fieldName 字段名称
  • account 账号
  • password 明文密码,如果没有可传 “” 或者 null
  • context 请求上下文,这里设置的 context 可以在 pipeline 的 context (opens new window) 中获取到,如不需要可传 null。

示例

JSONObject context = new JSONObject();
context.put("userId", "userId");
AuthClient.registerByExtendField("extendId", "188xxxx8888", "xxxxxx", context.toString(), (code, message, userInfo)->{
    if (code == 200) {
        // userInfo:用户信息
    }
});

错误码

  • 2026 用户名已存在

¶ 帐号密码登录

public static void loginByAccount(String account, String password, boolean autoRegister, String context, @NotNull AuthCallback<UserInfo> callback)

参数

  • account 可以是手机号 / 邮箱 / 用户名
  • password 明文密码
  • autoRegister 是否自动注册。如果检测到用户不存在,会根据登录账密自动创建一个账号。
  • context 请求上下文,这里设置的 context 可以在 pipeline 的 context (opens new window) 中获取到,如不需要可传 null。

示例

JSONObject context = new JSONObject();
context.put("userId", "userId");
AuthClient.loginByAccount("test", "xxxxxx", false, context.toString(), (code, message, userInfo)->{
    if (code == 200) {
        // userInfo:用户信息
    }
});

错误码

  • 2333 帐号或密码错误

¶ 邮箱验证码登录

通过邮箱验证码登录,需要先调用 发送邮件 接口(场景值为 VERIFY_CODE)。

public static void loginByEmailCode(String email, String code, boolean autoRegister, String context, @NotNull AuthCallback<UserInfo> callback)

参数

  • email 邮箱
  • code 验证码
  • autoRegister 是否自动注册。如果检测到用户不存在,会根据登录账密自动创建一个账号。
  • context 请求上下文,这里设置的 context 可以在 pipeline 的 context (opens new window) 中获取到,如不需要可传 null。

示例

JSONObject context = new JSONObject();
context.put("userId", "userId");
AuthClient.loginByEmailCode("test@example.com", "1234", false, context.toString(), (code, message, userInfo)->{
    if (code == 200) {
        // userInfo:用户信息
    }
});

错误码

  • 2001 验证码不正确

¶ 短信验证码登录

通过短信验证码登录,需要先调用 发送短信验证码 接口。

public static void loginByPhoneCode(String phoneCountryCode, String phone, String code, boolean autoRegister, String context, @NotNull AuthCallback<UserInfo> callback)

参数

  • phoneCountryCode 电话国家码。可以为空,为空时默认为 +86
  • phone 手机号
  • code 短信验证码
  • autoRegister 是否自动注册。如果检测到用户不存在,会根据登录账密自动创建一个账号。
  • context 请求上下文,这里设置的 context 可以在 pipeline 的 context (opens new window) 中获取到,如不需要可传 null。

示例

JSONObject context = new JSONObject();
context.put("userId", "userId");
AuthClient.loginByPhoneCode("+86", "188xxxx8888", "1234", false, context.toString(), (code, message, userInfo)->{
    if (code == 200) {
        // userInfo:用户信息
    }
});

错误码

  • 2001 短信验证码不正确

¶ 获取当前登录的用户信息

获取当前登录的用户信息,需要先登录

public static void getCurrentUser(@NotNull AuthCallback<UserInfo> callback)

示例

AuthClient.getCurrentUser((code, message, userInfo) -> {
    if (code == 200) {
        // userInfo:用户信息
    }
});

错误码

  • 2020 未登录

¶ 退出登录

退出登录。同时清除内存以及本地持久化的 token 和用户信息。退出登录后 Authing.getCurrentUser() 返回空

public static void logout(@NotNull AuthCallback<?> callback)

示例

// AuthFlow.start(this) will go to login page
AuthClient.logout((code, message, data)-> AuthFlow.start(this));

错误码

  • 1010001 如果用户的 id token 非法或者过期

¶ 发送短信验证码

向指定的手机发送短信验证码

public static void sendSms(String phoneCountryCode, String phone, @NotNull AuthCallback<?> callback)

参数

  • phoneCountryCode 电话国家码。可以为空,为空时默认为 +86
  • phone 手机号

示例

AuthClient.sendSms("+86", "188xxxx8888", (code, message, data)->{});

错误码

  • 500 手机号码格式非法

¶ 发送邮件

给指定邮箱发送邮件

public static void sendEmail(String emailAddress, String scene, @NotNull AuthCallback<JSONObject> callback)

参数

  • email 邮箱地址
  • scene 发送场景,可选值包含:
    • RESET_PASSWORD_VERIFY_CODE: 发送重置密码验证码邮件;
    • FIRST_EMAIL_LOGIN_VERIFY: 发送首次邮箱登录验证邮件;
    • CONSOLE_CONDUCTED_VERIFY: 发送控制台发起的验证邮件;
    • EMAIL_BIND_VERIFY_CODE: 发送邮箱绑定验证码邮件;
    • EMAIL_UNBIND_VERIFY_CODE: 发送邮箱解绑验证码邮件;
    • REGISTER_VERIFY_CODE: 发送注册验证码邮件;
    • LOGIN_VERIFY_CODE: 发送登录验证码邮件;
    • MFA_VERIFY_CODE: 发送 MFA 验证码邮件;
    • INFORMATION_COMPLETION_VERIFY_CODE: 发送信息补全验证码邮件;

示例

AuthClient.sendEmail("test@example.com", "RESET_PASSWORD",  (code, message, data)->{
    if (code == 200) {
        // 发送成功
    }
});

错误码

  • 1020017 邮箱地址非法

¶ 获取用户自定义数据

获取用户自定义数据,你需要先在用户池 定义用户自定义数据元信息

用户自定义数据会添加到传入的 userInfo 对象里面

调用此接口需要先登录

public static void getCustomUserData(UserInfo userInfo, @NotNull AuthCallback<UserInfo> callback)

参数

  • userInfo 用户信息对象

示例

AuthClient.getCustomUserData(Authing.getCurrentUser(), (code, message, data)->{
    if (code == 200) {
        
    }
});

错误码

  • 2020 未登录

¶ 设置用户自定义数据

设置用户的自定义数据。你需要先在用户池 定义用户自定义数据元信息,且传入值的类型必须和定义的类型匹配。

调用此接口需要先登录

public static void setCustomUserData(JSONObject customData, @NotNull AuthCallback<JSONObject> callback)

参数

  • customData key-value 形式的 JSONObject 对象

示例

JSONObject object = new JSONObject();
object.put("your_custom_data_key", "your_custom_data_value");
AuthClient.setCustomUserData(object, (code, message, res) -> {
    if (code == 200) {

    }
});

错误码

  • 2020 未登录

¶ 更新用户头像

通过从系统选择一张图片来更新用户头像

调用此接口需要先登录

public static void uploadAvatar(InputStream in, @NotNull AuthCallback<UserInfo> callback)

参数

  • in 图片输入流。推荐使用系统默认图片选择器获取

示例

启动系统默认图片选择器

Intent i = new Intent();
i.addCategory(Intent.CATEGORY_OPENABLE);
i.setType("image/*");
i.setAction(Intent.ACTION_GET_CONTENT);
((Activity) getContext()).startActivityForResult(Intent.createChooser(i, "Select Picture"), 1000);

通过以下回调拿到图片输入流,并调用更新头像接口

@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);

    if (resultCode == RESULT_OK && requestCode == 1000) {
        Uri selectedImageUri = data.getData();
        InputStream in;
        try {
            in = getContentResolver().openInputStream(selectedImageUri);
            AuthClient.uploadAvatar(in, (code, message, userInfo) -> runOnUiThread(()-> {
                // handle result
            }));
        } catch (FileNotFoundException e) {
            e.printStackTrace();
        }
    }
}

错误码

  • 2020 未登录

¶ 通过短信验证码重置密码

通过短信验证码重置密码,你可以通过 发送短信验证码 方法发送短信验证码

public static void resetPasswordByPhoneCode(String phoneCountryCode, String phone, String code, String newPassword, @NotNull AuthCallback<JSONObject> callback)

参数

  • phoneCountryCode 电话国家码。可以为空,为空时默认为 +86
  • phone 手机号
  • code 短信验证码
  • password 明文密码

示例

AuthClient.resetPasswordByPhoneCode("+86", "188xxxx8888", "1234", "xxxxxx", (code, message, data)->{
    if (code == 200) {

    }
});

错误码

  • 2004 用户不存在

¶ 通过邮件验证码重置密码

通过邮件验证码重置密码,你需要先调用 sendEmail 接口发送重置密码邮件(场景值为 RESET_PASSWORD)。

public static void resetPasswordByEmailCode(String emailAddress, String code, String newPassword, @NotNull AuthCallback<JSONObject> callback)

参数

  • email 邮箱地址
  • code 邮件验证码
  • password 明文密码

示例

AuthClient.resetPasswordByEmailCode("test@example.com", "1234", "xxxxxx", (code, message, data)->{
    if (code == 200) {

    }
});

错误码

  • 2004 用户不存在

¶ 修改用户资料

修改用户资料,此接口不能用于修改手机号、邮箱、密码

public static void updateProfile(JSONObject object, @NotNull AuthCallback<UserInfo> callback)

参数

  • object 需要修改的用户资料对象

可以通过此接口更新资料的字段:

  • username
  • nickname
  • company
  • photo
  • browser
  • device
  • name
  • givenName
  • familyName
  • middleName
  • profile
  • preferredUsername
  • website
  • gender
  • birthdate
  • zoneinfo
  • locale
  • address
  • streetAddress
  • locality
  • region
  • postalCode
  • city
  • province
  • country

示例

JSONObject body = new JSONObject();
body.put("username", "test");
body.put("nickname", "张三");
AuthClient.updateProfile(body, (code, message, userInfo)->{
    if (code == 200) {

    }
});

错误码

  • 2020 未登录

¶ 更新用户密码

更新用户密码。如果用户没有设置密码,如通过短信验证码、社会化登录等方式注册的,oldPassword 留空。

public static void updatePassword(String newPassword, String oldPassword, @NotNull AuthCallback<JSONObject> callback)

参数

  • newPassword 新密码
  • oldPassword 旧密码。可以为空

示例

AuthClient.updatePassword("newPassword", "oldPassword", (code, message, data) -> {
    if (code == 200) {

    }
});

错误码

  • 2020 未登录
  • 1320011 旧密码不正确

¶ 更新手机号

更新用户手机号码,调用 发送短信验证码 获取验证码。

public static void updatePhone(String phoneCountryCode, String phone, String code,
                               String oldPhoneCountryCode, String oldPhone, String oldCode,
                               @NotNull AuthCallback<UserInfo> callback)

参数

  • phoneCountryCode 新手机号国家码,需以 + 开头,如中国大陆为 +86
  • phone 新手机号
  • code 新手机号短信验证码
  • oldPhoneCountryCode 旧手机号国家码,需以 + 开头,如中国大陆为 +86
  • oldPhone 旧手机号
  • oldCode 旧手机号短信验证码

示例

AuthClient.updatePhone("+86", "188xxxx8888", "1234", "+86", "166xxxx6666", "1234",(code, message, data)->{
    if (code == 200) {
    }
});

错误码

  • 2020 未登录

¶ 绑定手机号

为当前登录用户绑定手机号。调用 发送短信验证码 获取验证码。

public static void bindPhone(String phoneCountryCode, String phone, String code, @NotNull AuthCallback<UserInfo> callback)

参数

  • phoneCountryCode 电话国家码。可以为空,为空时默认为 +86
  • phone 手机号
  • code 短信验证码

示例

AuthClient.bindPhone("188xxxx8888", "1234", (code, message, data)->{
    if (code == 200) {
    }
});

错误码

  • 2020 未登录

¶ 解绑手机号

用户解绑手机号,如果用户没有绑定其他登录方式(邮箱、社会化登录账号),将无法解绑手机号,会提示错误。

public static void unbindPhone(@NotNull AuthCallback<UserInfo> callback)

示例

AuthClient.unbindPhone((code, message, data)-> {
    if (code == 200) {
    }
});

错误码

  • 2020 未登录
  • 1320005 当前用户未绑定其他登录方式

¶ 绑定邮箱

为当前登录用户绑定邮箱。调用 发送邮件 获取验证码。

public static void bindEmail(String email, String code, @NotNull AuthCallback<UserInfo> callback)

参数

  • email 邮箱地址
  • code 邮件验证码

示例

AuthClient.bindEmail("test@example.com", "1234", (code, message, data)->{
    if (code == 200) {
    }
});

错误码

  • 2020 未登录

¶ 解绑邮箱

用户解绑邮箱,如果用户没有绑定其他登录方式(手机号、社会化登录账号),将无法解绑邮箱,会提示错误。

public static void unbindEmail(@NotNull AuthCallback<UserInfo> callback)

示例

AuthClient.unbindEmail((code, message, data)-> {
    if (code == 200) {
    }
});

错误码

  • 2020 未登录
  • 1320005 当前用户未绑定邮箱

¶ 计算密码安全等级

计算密码安全等级,返回三种级别:

  • EWeak: 等级低
  • EMedium: 等级中
  • EStrong: 等级高
public static PasswordStrength computePasswordSecurityLevel(String password)

示例

PasswordStrength result = AuthClient.computePasswordSecurityLevel("123"); // EWeak

¶ 获取用户账号安全等级

获取当前登录帐号的安全等级。

public static void getSecurityLevel(@NotNull AuthCallback<JSONObject> callback)

示例

AuthClient.getSecurityLevel((code, message, data)-> {
    if (code == 200) {
    }
});

回调 data 数据结构

{
    "score": 60,
    "email": false,
    "phone": false,
    "password": true,
    "passwordSecurityLevel": 1,
    "mfa": false
}

错误码

  • 2020 未登录

¶ 刷新当前用户的 Token

public static void updateIdToken(@NotNull AuthCallback<UserInfo> callback)

示例

AuthClient.updateIdToken((code, message, userInfo) ->{
    if (code == 200) {
    }
});

错误码

  • 2020 未登录

¶ 获取当前用户能够访问的应用

获取当前用户能够访问的应用。注意返回的结果数据结构为 List<Application>

public static void listApplications(int page, int limit, @NotNull AuthCallback<List<Application>> callback)

参数

  • page 分页序号, 默认为 1。
  • limit 每页返回的个数, 默认为 10。

示例

AuthClient.listApplications((code, message, applications) ->{
    if (code == 200) {
    }
});

返回结果示例

{
    "code": 200,
    "message": "获取可访问的应用列表成功",
    "data": {
        "list": [
            {
                "id": "61ae0c9807451d6f30226bd4",
                "name": "lance-test",
                "logo": "https://files.authing.co/authing-console/default-app-logo.png",
                "domain": "lance-test",
                "description": null,
                "createdAt": "2021-12-06T13:14:01.123Z",
                "updatedAt": "2022-01-20T10:51:02.806Z",
                "protocol": "oidc",
                "isIntegrate": false,
                "appType": "INDIVIDUAL",
                "template": null
            }
        ],
        "totalCount": 1
    }
}

错误码

  • 2020 未登录

¶ 获取用户所在组织机构

获取用户所在组织机构。由于用户可以在多个独立的组织机构树下,所以本接口返回了一个二位数组。注意返回的结果数据结构为 List<Organization[]>

public static void listOrgs(@NotNull AuthCallback<List<Organization[]>> callback)

示例

AuthClient.listOrgs((code, message, organizations)->{
    if (code == 200) {
    }
});

返回结果示例

{
    "code": 200,
    "message": "获取用户组织机构列表成功",
    "data": [
        [
            {
                "type": "org",
                "id": "6108e6fd64c0de1975728fe9",
                "createdAt": "2021-08-03T06:49:33.907Z",
                "updatedAt": "2021-08-03T06:49:33.920Z",
                "userPoolId": "60caaf41da89f1954875cee1",
                "rootNodeId": "6108e6fd552ad0a95a2ac771",
                "logo": null,
                "tenantId": null
            },
            {
                "type": "node",
                "id": "6108e6fd552ad0a95a2ac771",
                "createdAt": "2021-08-03T06:49:33.911Z",
                "updatedAt": "2021-08-03T06:49:33.911Z",
                "userPoolId": "60caaf41da89f1954875cee1",
                "orgId": "6108e6fd64c0de1975728fe9",
                "name": "HR",
                "nameI18n": null,
                "description": null,
                "descriptionI18n": null,
                "order": null,
                "code": null,
                "leaderUserId": null
            },
            {
                "type": "node",
                "id": "6108e710d2120ac0eb9af7d7",
                "createdAt": "2021-08-03T06:49:52.670Z",
                "updatedAt": "2021-08-03T06:49:52.670Z",
                "userPoolId": "60caaf41da89f1954875cee1",
                "orgId": "6108e6fd64c0de1975728fe9",
                "name": "DevHR",
                "nameI18n": null,
                "description": null,
                "descriptionI18n": null,
                "order": null,
                "code": null,
                "leaderUserId": null
            },
            {
                "type": "node",
                "id": "6108e7763c30fecb43f9b6a4",
                "createdAt": "2021-08-03T06:51:34.505Z",
                "updatedAt": "2021-08-03T06:51:34.505Z",
                "userPoolId": "60caaf41da89f1954875cee1",
                "orgId": "6108e6fd64c0de1975728fe9",
                "name": "JavaDevHR",
                "nameI18n": null,
                "description": null,
                "descriptionI18n": null,
                "order": null,
                "code": null,
                "leaderUserId": null
            }
        ],
        [
            {
                "type": "org",
                "id": "61e9408778066eaab14965de",
                "createdAt": "2022-01-20T10:59:19.035Z",
                "updatedAt": "2022-01-20T10:59:19.051Z",
                "userPoolId": "60caaf41da89f1954875cee1",
                "rootNodeId": "61e94087cf40643c9637e03c",
                "logo": null,
                "tenantId": null
            },
            {
                "type": "node",
                "id": "61e94087cf40643c9637e03c",
                "createdAt": "2022-01-20T10:59:19.042Z",
                "updatedAt": "2022-01-20T10:59:19.042Z",
                "userPoolId": "60caaf41da89f1954875cee1",
                "orgId": "61e9408778066eaab14965de",
                "name": "RD",
                "nameI18n": null,
                "description": null,
                "descriptionI18n": null,
                "order": null,
                "code": null,
                "leaderUserId": null
            },
            {
                "type": "node",
                "id": "61e94092ac13f7afd26d05b7",
                "createdAt": "2022-01-20T10:59:30.405Z",
                "updatedAt": "2022-01-20T10:59:30.405Z",
                "userPoolId": "60caaf41da89f1954875cee1",
                "orgId": "61e9408778066eaab14965de",
                "name": "Mobile",
                "nameI18n": null,
                "description": null,
                "descriptionI18n": null,
                "order": null,
                "code": null,
                "leaderUserId": null
            }
        ],
        [
            {
                "type": "org",
                "id": "6108e6fd64c0de1975728fe9",
                "createdAt": "2021-08-03T06:49:33.907Z",
                "updatedAt": "2021-08-03T06:49:33.920Z",
                "userPoolId": "60caaf41da89f1954875cee1",
                "rootNodeId": "6108e6fd552ad0a95a2ac771",
                "logo": null,
                "tenantId": null
            },
            {
                "type": "node",
                "id": "6108e6fd552ad0a95a2ac771",
                "createdAt": "2021-08-03T06:49:33.911Z",
                "updatedAt": "2021-08-03T06:49:33.911Z",
                "userPoolId": "60caaf41da89f1954875cee1",
                "orgId": "6108e6fd64c0de1975728fe9",
                "name": "HR",
                "nameI18n": null,
                "description": null,
                "descriptionI18n": null,
                "order": null,
                "code": null,
                "leaderUserId": null
            },
            {
                "type": "node",
                "id": "6108e710d2120ac0eb9af7d7",
                "createdAt": "2021-08-03T06:49:52.670Z",
                "updatedAt": "2021-08-03T06:49:52.670Z",
                "userPoolId": "60caaf41da89f1954875cee1",
                "orgId": "6108e6fd64c0de1975728fe9",
                "name": "DevHR",
                "nameI18n": null,
                "description": null,
                "descriptionI18n": null,
                "order": null,
                "code": null,
                "leaderUserId": null
            },
            {
                "type": "node",
                "id": "62039e6b017b8cf3b5bb6ec4",
                "createdAt": "2022-02-09T10:58:51.422Z",
                "updatedAt": "2022-02-09T10:59:16.718Z",
                "userPoolId": "60caaf41da89f1954875cee1",
                "orgId": "6108e6fd64c0de1975728fe9",
                "name": "SwiftDevHR",
                "nameI18n": null,
                "description": "",
                "descriptionI18n": null,
                "order": null,
                "code": null,
                "leaderUserId": null
            }
        ]
    ]
}

错误码

  • 2020 未登录

¶ 获取角色

获取当前登录用户的角色。注意返回的数据结构为 List<Role>

public static void listRoles(String namespace, @NotNull AuthCallback<List<Role>> callback)

参数

  • namespace 权限分组 ID,用来过滤角色数据。如果传空,则返回用户所有角色

示例

AuthClient.listRoles(null, (code, message, roles) ->{
    if (code == 200) {
    }
});

返回结果示例

{
    "code": 200,
    "message": "获取成功",
    "data": [
        {
            "id": "61ada935ce061fe3476f0f09",
            "createdAt": "2021-12-06T06:09:57.523Z",
            "updatedAt": "2021-12-06T06:09:57.523Z",
            "userPoolId": "60caaf41da89f1954875cee1",
            "code": "admin",
            "description": null,
            "parentCode": null,
            "isSystem": false,
            "namespaceId": 36141,
            "namespace": "60caaf414f9323f25f64b2f4"
        }
    ]
}

错误码

  • 2020 未登录

¶ 获取用户被授权的所有资源列表

获取一个用户被授权的所有资源,用户被授权的所有资源里面包括从角色、分组、组织机构继承的资源。

public static void listAuthorizedResources(String namespace, String resourceType, @NotNull AuthCallback<List<Resource>> callback)

参数

  • namespace 权限分组 ID
  • resourceType 资源类型。可以为以下几种类型 DATA, API, MENU, UI, BUTTON。如果传空,则返回所有资源类型数据

示例

AuthClient.listAuthorizedResources("default", (code, message, resources)->{
    if (code == 200) {
    }
});

返回结果示例

{
    "totalCount": 1,
    "list": [
        {
            "code": "ci:*",
            "type": "DATA",
            "actions": [
                "*"
            ],
            "apiIdentifier": null
        }
    ]
}

错误码

  • 2020 未登录

¶ 通过首次登录的 Token 重置密码

通过首次登录的 Token 重置密码,需要在创建用户时设置“强制用户首次登录时修改密码”

public static void resetPasswordByFirstTimeLoginToken(String token, String newPassword, @NotNull AuthCallback<JSONObject> callback)

参数

  • token 首次登录后获取的 token
  • password 明文密码

示例

AuthClient.resetPasswordByFirstTimeLoginToken(token, password, (code, message, data)->{
    if (code == 200) {
    }
});

¶ 删除帐号

用户自助删除当前登录帐号。

此操作不可逆,请务必给用户足够的提示

public static void deleteAccount(AuthCallback<JSONObject> callback)

示例

private void deleteAccount() {
    new AlertDialog.Builder(this).setIcon(android.R.drawable.ic_dialog_alert)
            .setTitle(R.string.authing_delete_account).setMessage(R.string.authing_delete_account_tip)
            .setPositiveButton(android.R.string.yes, (dialog, which) -> AuthClient.deleteAccount((code, message, data) -> {
                if (code == 200) {
                    AuthFlow.start(UserProfileActivity.this);
                } else {
                    runOnUiThread(()->Toast.makeText(UserProfileActivity.this, message, Toast.LENGTH_LONG).show());
                }
            }))
            .setNegativeButton(android.R.string.no, null).show();
}

¶ 判断用户是否存在

public static void checkAccount(String paramsName, String paramsValue, @NotNull AuthCallback<JSONObject> callback)

参数

  • paramsName 参数名称,email(邮箱)、phone(手机号)、username(用户名)、externalId(自定义的id) 传其中一个
  • paramsValue 对应参数的值

示例

AuthClient.checkAccount("phone", "188xxxx8888", (code, message, data) -> {
    if (code == 200) {
        //hasAccount = true   账号存在
        //hasAccount = false  账号不存在
				boolean hasAccount = data.has("result") && data.optBoolean("result");
    }
});

上一篇: APIs 下一篇: 标准协议 API
  • 邮箱注册
  • 邮箱验证码注册
  • 用户名注册
  • 短信验证码注册
  • 自定义字段注册
  • 帐号密码登录
  • 邮箱验证码登录
  • 短信验证码登录
  • 获取当前登录的用户信息
  • 退出登录
  • 发送短信验证码
  • 发送邮件
  • 获取用户自定义数据
  • 设置用户自定义数据
  • 更新用户头像
  • 通过短信验证码重置密码
  • 通过邮件验证码重置密码
  • 修改用户资料
  • 更新用户密码
  • 更新手机号
  • 绑定手机号
  • 解绑手机号
  • 绑定邮箱
  • 解绑邮箱
  • 计算密码安全等级
  • 获取用户账号安全等级
  • 刷新当前用户的 Token
  • 获取当前用户能够访问的应用
  • 获取用户所在组织机构
  • 获取角色
  • 获取用户被授权的所有资源列表
  • 通过首次登录的 Token 重置密码
  • 删除帐号
  • 判断用户是否存在

用户身份管理

集成第三方登录
手机号闪验 (opens new window)
通用登录表单组件
自定义认证流程

企业内部管理

单点登录
多因素认证
权限管理

开发者

开发文档
框架集成
博客 (opens new window)
GitHub (opens new window)
社区用户中心 (opens new window)

公司

400 888 2106
sales@authing.cn
北京市朝阳区北辰世纪中心 B 座 16 层(总)
成都市高新区天府五街 200 号 1 号楼 B 区 4 楼 406 室(分)

京ICP备19051205号

beian京公网安备 11010802035968号

© 北京蒸汽记忆科技有限公司