¶ 扫码认证 API

更新时间: 2025-05-14 08:32:28

要使用自建 App 扫码登录能力，请在 Authing 控制台勾选 "App 扫码登录" 选项。

当 Web 应用需要登录时，登录界面会显示一个可供 App 扫码的二维码，如下图：

二维码数据结构如下：

{
    "scene": "APP_AUTH",
    "random": "5e05f0c57fde537d950f7da5",
    "userPoolId": "5e04ae0d5f3cee22fb37612b",
    "createdAt": "2019-12-27T11:53:41.260Z",
    "expireAt": "2019-12-27T11:55:41.260Z"
}

在 App 侧，确保 App 处于登录状态，在需要授权登录时，依次调用下面 API

¶ 标记二维码

此接口调用成功后，网页的二维码上面会显示用户头像

注意：调用此接口前，App 必须处于登录状态

public static void markQRCodeScanned(String ticket, @NotNull AuthCallback<JSONObject> callback)

参数

ticket 二维码数据里面的 random 字段

示例

AuthClient.markQRCodeScanned(random, (code, message, data) -> {
    if (code == 200) {
        // notify user to authorize
    }
});

错误码

500 无效二维码
2020 未登录

¶ 确认二维码登录

使用二维码登录。分两步的好处是，App 可以在扫描之后给用户一个提示，待用户确认之后再授权登录。

注意：调用此接口之前必须先调用标记二维码

public static void loginByScannedTicket(String ticket, @NotNull AuthCallback<JSONObject> callback)

参数

ticket 二维码数据里面的 random 字段

示例

AuthClient.loginByScannedTicket(random, (code, message, data) -> {
    if (code == 200) {
        // logged in
    }
});

错误码

500 无效二维码
2020 未登录

¶ 取消二维码登录

App 可以在扫描之后，若想取消授权登录，调用此接口。

public static void cancelByScannedTicket(String ticket, @NotNull AuthCallback<JSONObject> callback)

参数

ticket 二维码数据里面的 random 字段

示例

AuthClient.cancelByScannedTicket(random, (code, message, data) -> {
    if (code == 200) {
        // Success to cancel
    }
});

错误码

500 无效二维码
2020 未登录