执行微信登录（Step 3）

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

接口地址： POST /getIPadLoginInfo

快速登录

只想快速登录，可直接在 控制台 → 微信管理 在线扫码。

请求参数

参数名	必选	类型	说明
wId	是	string	Step 2 返回的登录实例标识
autoCheck	是	boolean	是否自动验证。mac 设备类型可传 true，其他场景传 false
verifyCode	否	string	验证码。接口提示需要验证码时传入

登录确认流程

iPad 模式

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

Mac 模式（autoCheck = true）

1. 调用本接口后等待约 10 秒。
2. 手机自动弹出确认页面。
3. 点击确认后，接口返回登录成功。

Mac 模式（autoCheck = false）

1. 接口返回验证二维码 URL。
2. 使用 认证 APP 扫描二维码。
3. 验证通过后再次调用本接口。
4. 手机点击确认，接口返回登录成功。

WARNING

本接口是长轮询接口，最长等待 250 秒返回。如已有自己的验证 APP，可接入自有验证流程，不必下载上方 APP。

响应参数

参数名	类型	说明
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://api.e-yun.example/qrcode/verify-aidnet.png"
  }
}

错误响应

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

下一步

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