执行微信登录（Step 3）

扫码后调用本接口完成登录确认，并获取微信实例信息。登录成功后，请保存返回的 wId 和 wcId。

接口地址： POST /getIPadLoginInfo

快速登录

如果不需要通过 API 完整走登录流程，可直接在 控制台 → 微信管理 在线扫码登录。

请求参数

参数名	必选	类型	说明
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，否则可能创建新设备并导致频繁掉线。
• 正确传入 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 发送一条测试消息。