获取登录二维码（Step 2）

生成微信扫码二维码，返回 wId 和 qrCodeUrl。用户扫码后，继续调用 Step 3 确认登录。

接口地址： POST /iPadLogin

快速登录

只想快速拿到实例，可在控制台的微信管理扫码。登录后可获得 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、自定义代理、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 版本；需要长期固定出口时，再部署 Linux 节点。

方式	适合场景	入口
Windows 本地代理	客服电脑、运营电脑、门店电脑、家用电脑	下载 Windows 64 位 Aid
Linux 固定节点	同城市服务器、家用电脑、自购盒子、虚拟机	查看 Aid 本地代理部署

TIP

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

代理注意事项

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

响应参数

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

请求示例

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

json

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

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

json

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

使用平台网络代理：

json

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

使用 Aid 本地代理：

json

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

使用自定义代理：

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。

获取登录二维码（Step 2） ​

请求参数 ​

设备类型 ​

代理选择 ​

平台网络代理线路 ​

Aid 本地代理 ​

响应参数 ​

请求示例 ​

成功响应 ​

错误响应 ​

下一步 ​

获取登录二维码（Step 2）

请求参数

设备类型

代理选择

平台网络代理线路

Aid 本地代理

响应参数

请求示例

成功响应

错误响应

下一步