Appearance
获取登录二维码（Step 2）
生成微信扫码登录二维码，并返回 wId。
扫码后调用 Step 3 完成登录确认。
接口地址： POST /iPadLogin
快速登录
不想用 API 完整登录时，可在 控制台 的微信管理扫码。登录成功后，可获得 wId 和 wcId。
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| wcId | 是 | string | 微信 ID。首次登录传 ""；掉线重登必须传上次登录返回的 wcId |
| deviceType | 是 | string | 设备类型：ipad 推荐；mac 会影响电脑端微信登录状态 |
| proxy | 否 | int | 平台网络代理线路编号。需要指定平台线路时传入 |
| proxyIp | 否 | string | 自定义代理 IP + 端口。需要使用自有代理时传入 |
| proxyUser | 否 | string | 自定义代理账号 |
| proxyPassword | 否 | string | 自定义代理密码 |
| aid | 否 | string | Aid 本地代理标识。使用 Aid 本地代理时传入，登录期间必须保持 Aid 工具运行 |
设备类型
| 类型 | 说明 | 建议 |
|---|---|---|
ipad | 不影响手机端和电脑端微信使用 | 推荐 |
mac | 电脑端微信可能被挤下线 | 仅在业务确认需要时使用 |
WARNING
- 掉线重登时，
wcId和deviceType必须与上次登录保持一致。 - 首次登录新设备时，手机端可能弹出验证确认，需要继续调用 执行微信登录（Step 3） 处理。
代理选择
默认可以不传 proxy、proxyIp 和 aid，直接生成二维码并扫码登录。只有需要指定登录网络时，才选择下面任意一种方式。
| 方式 | 参数 | 适用场景 | 注意事项 |
|---|---|---|---|
| 平台网络代理 | proxy | 希望按省份选择平台线路 | 可选 |
| Aid 本地代理 | aid | 需要使用本地网络环境登录 | 可选；使用期间 Aid 工具必须一直运行 |
| 自定义代理 | proxyIp + proxyUser + proxyPassword | 使用自有 Socks5 代理 | 可选；代理需要稳定可访问 |
代理优先级：Aid 本地代理 > 自定义代理 > 平台网络代理。
平台网络代理线路
| 编号 | 地区 | 编号 | 地区 | 编号 | 地区 |
|---|---|---|---|---|---|
| 1 | 北京 | 11 | 江西 | 21 | 黑龙江 |
| 2 | 天津 | 12 | 山东 | 22 | 辽宁 |
| 3 | 上海 | 13 | 河南 | 23 | 贵州 |
| 4 | 重庆 | 14 | 湖北 | 24 | 广西 |
| 5 | 河北 | 15 | 湖南 | 25 | 宁夏 |
| 6 | 山西 | 16 | 广东 | 26 | 青海 |
| 7 | 江苏 | 17 | 海南 | 27 | 甘肃 |
| 8 | 浙江 | 18 | 四川 | 28 | 西藏 |
| 9 | 安徽 | 19 | 云南 | 29 | 吉林 |
| 10 | 福建 | 20 | 陕西 | 30 | 内蒙古 |
Aid 本地代理工具下载
使用 aid 前，请下载并打开对应系统版本的 Aid 工具。登录期间 Aid 工具必须保持运行。
| 系统 | 下载地址 |
|---|---|
| Windows 64 位 | wechat-AidNet-win64.exe.zip |
| macOS Intel | wechat-AidNet-mac-x64.dmg.zip |
| macOS Apple Silicon | wechat-AidNet-mac-arm64.dmg.zip |
代理注意事项
- 若平台线路不包含你所在城市，且无法使用 Aid 本地代理，请使用自定义代理。
- 自定义代理传入后如返回“网络链接异常”，请先验证代理 IP、端口、账号、密码是否可用。
- 若扫码后手机显示的登录地区与预期不符，请联系技术支持排查线路。
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | string | 1000 成功，1001 失败 |
| message | string | 反馈信息 |
| data.wId | string | 登录实例标识。每次登录可能变化，请实时保存 |
| data.qrCodeUrl | string | 二维码图片 URL，用于微信扫码 |
请求示例
首次登录：
json
{
"wcId": "",
"deviceType": "ipad"
}掉线重登：
json
{
"wcId": "wxid_6tn88z16x6ou12",
"deviceType": "ipad"
}使用平台网络代理：
json
{
"wcId": "",
"deviceType": "ipad",
"proxy": 16
}使用 Aid 本地代理：
json
{
"wcId": "",
"deviceType": "ipad",
"aid": "aid_local_9f3a7c21"
}使用自定义代理：
json
{
"wcId": "",
"deviceType": "ipad",
"proxyIp": "121.229.46.245:3829",
"proxyUser": "proxy-user",
"proxyPassword": "proxy-password"
}成功响应
json
{
"code": "1000",
"message": "登录成功",
"data": {
"wId": "0000016e-63ef-3a9c-0001-ed3311628ef4",
"qrCodeUrl": "https://api.e-yun.example/qrcode/login-aidnet.png"
}
}错误响应
json
{
"code": "1001",
"message": "网络链接异常",
"data": null
}下一步
扫码后继续调用 执行微信登录（Step 3），确认登录并获取 wcId。