账号密码登录

当无法正常扫码登录（手机端出现验证弹窗）时，使用微信账号密码完成登录。

接口地址： POST /loginByAccountAndPassword

高级能力

• 本接口仅用于手机出现验证弹窗导致无法正常扫码登录的特殊场景。
• 正常接入请使用 获取登录二维码（Step 2）。
• 涉及微信账号和密码，业务系统不得记录明文密码。

调用流程

本接口需分两步调用：

第一步： 传入 account、password、proxy 发起登录 → 返回 wId 和 base64 二维码图片

第二步： 用原手机扫描第一步返回的二维码完成验证 → 传入 account、password、proxy、wId 再次调用本接口 → 返回登录成功

TIP

账号密码登录是特殊高级接口，仍需要传入 proxy。这不代表常规扫码登录必须选择平台线路；常规登录请以 获取登录二维码（Step 2） 的可选代理说明为准。

后续登录

完成以上操作后，手机微信会处于退出状态。重新在手机登录微信后，使用 wcId 调用 Step 2、Step 3 即可正常登录，不会再出现验证。

请求参数

参数名	必选	类型	说明
wId	否	string	登录实例标识（第二步传入第一步返回的值）
wcId	否	string	微信 ID。首次登录传 ""，掉线重登必须传值
account	是	string	微信账号
password	是	string	微信密码
proxy	是	int	代理线路编号（1-30），参见 Step 2 线路表
proxyIp	否	string	自定义代理 IP + 端口
proxyUser	否	string	自定义代理账号
proxyPassword	否	string	自定义代理密码

第一步响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data.wId	string	登录实例标识（第二步需传入）
data.base64	string	验证二维码（Base64 编码）

第二步响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
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	识别码

请求示例

第一步 — 发起账号密码登录：

{
 "wId": "",
 "wcId": "",
 "account": "your_wechat_account",
 "password": "your_password",
 "proxy": 7
}

第二步 — 扫码验证后再次调用：

{
 "wId": "4cc5809a-7e4b-4c61-9dc1-a2c90ee53f8f",
 "wcId": "",
 "account": "your_wechat_account",
 "password": "your_password",
 "proxy": 7
}

第一步成功响应

{
 "code": "1000",
 "message": "处理成功",
 "data": {
 "wId": "4cc5809a-7e4b-4c61-9dc1-a2c90ee53f8f",
 "base64": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
 }
}

第二步成功响应

{
 "code": "1000",
 "message": "处理成功",
 "data": {
 "wcId": "wxid_ylxtxxg0p8bx22",
 "wId": "25d50610-1a82-4531-b9db-dd80c5a3c14a",
 "wAccount": "hi1212",
 "nickName": "贝塔同学",
 "sex": 2,
 "headUrl": "https://wx.qlogo.cn/mmhead/AbCdEfGhIjKlMnOpQrStUv/0",
 "mobilePhone": "198****1231",
 "uin": 124723525,
 "status": 3
 }
}

错误响应

{
 "code": "1001",
 "message": "用户名或密码错误",
 "data": null
}

使用建议

• 本接口只用于扫码登录无法完成的特殊验证场景；新接入仍优先使用扫码登录链路。
• 账号密码属于高敏感信息，业务系统不得记录明文密码。
• 第二步登录成功后，应更新本地保存的 wId，并继续按 wcId 管理微信账号。