执行微信登录（Step 3）

适用场景

仅当你要把微信登录流程集成到自己的后台时，才需要调用本接口。如果使用 Eyun 控制台登录，请直接在「微信执行实例」扫码，无需调用 Step 1–3。

用户扫码后调用本接口确认登录。成功后必须保存返回的 wId 和 wcId。

接口地址： POST /getIPadLoginInfo

请求参数

参数名	必选	类型	说明
wId	是	string	Step 2 返回的登录实例标识
autoCheck	是	boolean	是否自动验证。Mac、iPad 接入流程均显式传 false，按返回的验证步骤继续；示例保持一致
verifyCode	否	string	验证码。接口提示需要验证码时传入

登录确认流程

iPad 模式（autoCheck = false）

1. 调用本接口后，手机可能提示“在新设备完成验证”。
2. 接口返回验证二维码 URL（code = "200"）。
3. 使用 安盾 APP 扫描二维码完成人脸验证。
4. 验证通过后再次调用本接口。
5. 手机点击“确认登录”，接口返回登录成功。

Mac 模式（autoCheck = false）

1. 接口返回验证二维码 URL。
2. 下载并安装 Android AID，使用工具扫描二维码。
3. 在 Android AID 中完成滑块验证，验证通过后再次调用本接口。
4. 在手机上点击确认，接口返回登录成功。

长轮询与客户端集成

本接口是长轮询接口，最长等待 250 秒返回。

对于 Mac 模式，Android AID 是可直接使用的现成工具。如果业务已有自己的 Android App 或 Windows EXE，可将 Aid 节点和滑块验证能力集成到自有客户端，无需另行下载 Android AID。

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败，200 需要验证
message	string	反馈信息
data.wcId	string	微信 ID，唯一值，必须持久化保存
data.wId	string	登录实例标识
data.nickName	string	微信昵称
data.wAccount	string	微信号
data.headUrl	string	头像 URL
data.sex	int	性别
data.mobilePhone	string	绑定手机号
data.deviceType	string	设备类型
data.uin	int	微信识别码

首次登录须知

• 首次登录后 24 小时内可能掉线一次，属正常现象。
• 掉线重登必须传原 wcId，否则可能生成新设备并增加掉线概率。
• 登录后 72 小时内不建议发送朋友圈。
• 登录成功后，手机顶部会显示 iPad 或 Mac 在线状态。
• 若登录后 60 秒内无故掉线，请参阅 API 使用与安全。

请求示例

{
  "wId": "0000016e-63eb-f319-0001-ed01076abf1f",
  "autoCheck": false
}

成功响应

{
  "code": "1000",
  "message": "处理成功",
  "data": {
    "wcId": "wxid_6tn88z16x6ou12",
    "wId": "0000016e-63eb-f319-0001-ed01076abf1f",
    "wAccount": "my_wechat_id",
    "nickName": "张三",
    "headUrl": "https://wx.qlogo.cn/mmhead/AbCdEfGhIjKlMnOpQrStUv/0",
    "sex": 1,
    "mobilePhone": "138****1234",
    "deviceType": "ipad",
    "uin": 124723525
  }
}

需要验证响应

{
  "code": "200",
  "message": "处理成功",
  "data": {
    "url": "https://你的接口域名/qrcode/verify-aidnet.png"
  }
}

错误响应

{
  "code": "1001",
  "message": "失败",
  "data": null
}

下一步

登录成功后，先调用 发送文本 给 filehelper 发送测试消息。