执行登录(步骤2) - GeHub｜微信 API 开发文档

提示：登录模块为必要步骤，如需简化流程，可跳过步骤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

• AID+Mac滑块验证 APP （二合一版)(Android)

登录流程图

Ipad登录流程图

Mac登录流程图

请求参数

Header 参数

X-GEHUB-TOKEN

string

必需

示例:

Body 参数application/json

appId

string

兼容占位，可省略；按客户端绑定选择节点

uuid

string

取码返回的uuid

必需

autoSliding

boolean

可选

autoSliding 参数说明
用于控制登录验证方式（仅 mac 登录有效）：
true：自动验证（无需额外操作）
false：手动验证（需通过 App 完成）
建议：
自动验证优先使用
若验证失败，可切换为手动验证

proxyIp

string

可选

代理IP 格式：socks5://username:password@123.2.2.2

captchCode

string

可选

手机若提示需要输入验证码传输

示例

{
    "appId": "{{appid}}",
    "proxyIp": "",
    "uuid": "obpAjgWNiBmumFz5VHmm",
    "autoSliding": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

ret

integer

必需

msg

string

必需

data

object

响应数据

必需

uuid

string

二维码的uuid

必需

headImgUrl

string

头像地址

必需

nickName

string

昵称

必需

expiredTime

integer

二维码超时时间

必需

status

integer

必需

状态 0：未扫码 1：已扫码未登录 2：登录成功

loginInfo

object

登录成功信息

必需

示例

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

{
    "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"
    }
}