获取登录二维码（Step 2）

适用场景

仅当你要把微信登录流程集成到自己的后台时，才需要调用本接口。如果使用 Eyun 控制台登录，请直接在「微信执行实例」添加实例并扫码，无需调用 Step 1–3。

由你的后台请求 Eyun 生成微信扫码二维码，返回 wId 和 qrCodeUrl。用户扫码后，继续调用 Step 3 确认登录。

接口地址： POST /iPadLogin

请求参数

参数名	必选	类型	说明
wcId	是	string	微信 ID。首次登录传 ""；掉线重登传上次返回的 wcId
deviceType	是	string	设备类型：ipad 推荐；mac 会影响电脑端微信登录状态
proxy	三选一	int	平台网络代理线路编号。选择平台代理时传入
proxyIp	三选一	string	自定义代理 IP + 端口。选择自定义代理时传入
proxyUser	三选一	string	自定义代理账号。选择自定义代理时传入
proxyPassword	三选一	string	自定义代理密码。选择自定义代理时传入
aid	三选一	string	Aid 本地代理编号，可由 Windows / Android / Linux 版本提供。选择 Aid 时传入，登录期间必须保持 Aid 工具运行

设备类型

类型	说明	建议
ipad	不影响手机端和电脑端微信使用	推荐
mac	电脑端微信可能被挤下线	仅在业务确认需要时使用

WARNING

• 掉线重登时，wcId 和 deviceType 必须与上次登录保持一致。
• 首次登录新设备时，手机端可能弹出验证确认，需要继续调用 执行微信登录（Step 3） 处理。

代理选择

每次生成二维码都必须指定一种登录网络，且只能三选一：proxy、自定义代理、aid。

方式	参数	适用场景	注意事项
平台网络代理	proxy	希望按省份选择平台线路	必选其一
Aid 本地代理	aid	需要使用本地网络登录	必选其一；登录期间 Aid 工具必须一直运行
自定义代理	proxyIp + proxyUser + proxyPassword	使用自有 Socks5 代理	必选其一；代理需要稳定可访问

不要同时传多种网络参数。若同时传入，可能导致登录网络不符合预期。

平台网络代理线路

编号	地区	编号	地区	编号	地区
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 节点。按场景选：Windows 桌面环境用 Windows 版；想让出口贴近家庭宽带或移动网络、或 Mac 模式需要扫验证二维码时用 Android 版；需要 7×24 固定出口时部署 Linux 节点。

方式	适合场景	入口
Windows AID	客服电脑、运营电脑、门店电脑、家用电脑	下载 Windows 64 位 Aid
Android AID	Android 手机或 Android 设备，兼做 Mac 登录验证	查看 Android AID
Linux AID	同城市服务器、家用电脑、自购盒子、虚拟机	查看 Aid 本地代理部署

TIP

Linux 节点不建议部署在普通云服务器。云服务器出口 IP、带宽质量和登录城市经常不贴近账号常用环境，容易造成扫码异常或掉线。

代理注意事项

• 若平台线路不包含你所在城市，且无法使用 Aid 本地代理，请使用自定义代理。
• 自定义代理传入后如返回“网络链接异常”，请先验证代理 IP、端口、账号、密码是否可用。
• 若扫码后手机显示的登录地区与预期不符，请联系技术支持排查线路。

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data.wId	string	登录实例标识。每次登录可能变化，请实时保存
data.qrCodeUrl	string	二维码图片 URL，用于微信扫码

请求示例

首次登录使用平台网络代理：

{
  "wcId": "",
  "deviceType": "ipad",
  "proxy": 16
}

掉线重登仍需指定网络方式：

{
  "wcId": "wxid_6tn88z16x6ou12",
  "deviceType": "ipad",
  "proxy": 16
}

使用平台网络代理：

{
  "wcId": "",
  "deviceType": "ipad",
  "proxy": 16
}

使用 Aid 本地代理：

{
  "wcId": "",
  "deviceType": "ipad",
  "aid": "703314"
}

使用自定义代理：

{
  "wcId": "",
  "deviceType": "ipad",
  "proxyIp": "121.229.46.245:3829",
  "proxyUser": "proxy-user",
  "proxyPassword": "proxy-password"
}

成功响应

{
  "code": "1000",
  "message": "登录成功",
  "data": {
    "wId": "0000016e-63ef-3a9c-0001-ed3311628ef4",
    "qrCodeUrl": "https://你的接口域名/qrcode/login-aidnet.png"
  }
}

错误响应

{
  "code": "1001",
  "message": "网络链接异常",
  "data": null
}

下一步

扫码后调用 执行微信登录（Step 3），确认登录并保存 wcId。