执行登录(步骤2)

提示：登录模块为必要步骤，如需简化流程，可跳过步骤1与步骤2，直接通过后台在线登录获取 appId 后进行接口调用。

必看说明

登录验证说明

获取二维码后，可通过本接口轮询登录状态。

建议调用间隔：5 秒
二维码有效期：150 秒

iPad 登录流程

调用接口，手机提示“在新设备完成验证”

接口返回二维码地址

通过人脸识别 App 扫码完成验证

再次调用接口，并在手机端确认登录

Mac 登录流程

新设备同样会触发验证提示，根据 autoCheck 参数不同，流程有区别。

autoCheck=true：

约 15 秒后自动跳转确认页，手机点击确认即可登录。

autoCheck=false：

接口返回二维码地址，需通过验证 App 扫码后再次调用接口完成登录。

接口作用说明

本接口为轮询接口，用于检测登录状态（如滑块验证、扫码确认、登录成功等）。

登录成功后，手机顶部显示设备在线（iPad/Mac），方可正常收发消息及调用其他接口。

登录稳定性说明

新设备首次登录后，24 小时内可能掉线一次；

掉线后需传 wcid 重新获取二维码登录，稳定后可长期在线（约 3 个月）。

相关工具下载

• iPad 登录人脸识别 App（仅支持 iOS，请使用 Safari 打开）

• Mac 登录滑块验证 App

登录流程图

Ipad登录流程图

Mac登录流程图

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

扫码但未点确认时的响应登录成功

{
    "ret": 200,
    "msg": "操作成功",
    "data": {
        "uuid": "AZ0yN8d1wJmiNfQBKFgu",
        "headImgUrl": "http://wx.qlogo.cn/mmhead/ver_1/ZYUmcl1UNzyB2onM08Ij901TaUOLIjHj2UicK3XGDsjEWl4XgQN5IjodunHicBVsZiaZc1iaGCRfluAxkzyibbiau3WBfFj2nprzKp2KryicMjGIvDbWOQGmibwVK648a3o4A8hD/0",
        "nickName": "G",
        "expiredTime": 225,
        "status": 1,
        "loginInfo": null
    }
}
//需人脸/滑块 验证返回
{
    "ret": 200,
    "msg": "操作成功",
    "data": {
        "url": "http://api.asilu.com/qrcode/?t=http://182.40.96.72:8081/s/01KCJGKJ73YTBGQQKAZ4ZH13ZF"
    }
}

请求参数

请求示例代码

返回响应