执行微信登录

轮询登录结果。用户扫码后，接口会先返回头像和昵称；用户在手机端确认登录后，接口返回完整登录信息。

接口地址： POST /simpleIPadLoginInfo

注意

• 每 2-3 秒请求一次；登录成功后立即停止轮询。
• 手机端确认登录成功后，才可以收发消息和调用其他微信实例接口。
• 首次登录平台后，掉线规则见 API 使用规范：登录与掉线。

前置条件

• 已调用获取登录二维码接口并拿到 wId。
• 用户已扫码，或正在等待用户在手机端确认登录。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识

请求示例

{
  "wId": "59c7a5b1-3c01-480c-828c-46eade762287"
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object	登录信息
data.wId	string	登录实例标识
data.wcId	string	微信 ID
data.nickName	string	微信昵称
data.headUrl	string	头像 URL
data.smallHeadImgUrl	string	小头像 URL
data.wAccount	string	手机端显示的微信号
data.username	string	用户名字段，按接口返回值使用
data.mobilePhone	string	绑定手机
data.sex	int	性别
data.country	string	国家
data.city	string	城市
data.signature	string	个性签名
data.type	int	登录类型
data.status	int	登录状态

成功响应

{
  "code": "1000",
  "message": "处理成功",
  "data": {
    "country": "CN",
    "wAccount": "hi1212",
    "city": "",
    "signature": "我的签名如风一样难以琢磨",
    "nickName": "贝塔同学",
    "sex": 2,
    "headUrl": "http://wx.qlogo.cn/mmhead/ver_1/example/0",
    "type": 2,
    "smallHeadImgUrl": "http://wx.qlogo.cn/mmhead/ver_1/example/132",
    "wcId": "wxid_ylxtxxg0p8bx22",
    "wId": "25d50610-1a82-4531-b9db-dd80c5a3c14a",
    "mobilePhone": "19822121231",
    "status": 3,
    "username": "18013350963"
  }
}

错误响应

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

使用建议

• 登录成功后保存 wId 和 wcId：wId 用于实例接口调用，wcId 用于识别微信账号。
• 轮询时要设置超时和取消逻辑，避免用户长时间未确认导致无效请求。
• 如果接口提示需要设备验证，按刷新设备接口流程处理后再继续登录。