获取二维码(第二步-方式1)
请求URL:
http://域名地址/iPadLogin
请求方式:
- POST
请求头Headers:
- Content-Type:application/json
- Authorization:login接口返回
参数:
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
wcId | 是 | string | 微信原始id (首次登录平台的号传"",掉线重登必须传值,否则会频繁掉线!!!) 第3步会返回此字段,记得入库保存 |
proxy | 是 | int | 测试长效代理线路 1:北京 2:天津 3:上海 4:重庆 5:河北 6:山西 7:江苏 8:浙江 9:安徽 10:福建 11:江西 12:山东 13:河南 14:湖北 15:湖南 16:广东 17:海南 18:四川 19:云南 20:陕西 21:黑龙江 22:辽宁 23:贵州 24:广西 25:宁夏 26:青海 27:甘肃 28:西藏 29:吉林 30:内蒙 |
deviceType | 是 | string | 设备类型:ipad、mac【推荐】 |
proxyIp | 否 | string | 自定义长效代理IP+端口 |
proxyUser | 否 | string | 自定义长效代理IP平台账号 |
proxyPassword | 否 | string | 自定义长效代理IP平台密码 |
[!NOTE] 快速TIP:登录模块是本平台的必须步骤,若觉得过于繁琐,可省略第2步与第3步的登录步骤,直接在后台在线登录获取wid与wcId调用接口
关于deviceType字段的使用说明:
- 因大部分ipad方式取码登录,手机上会出现'在新设备完成验证以继续登录',导致无法登录成功,此时需要使用本字段,也就是切换Mac方式登录,用户可按需选择直至登录成功:
- 方式1:第一次登录传mac,掉线后再次登录需传wcid和deviceType。(PS:和上次设备类型需一致,本方式登录,手机有概率会显示新设备验证,调用执行登录接口可通过该验证,采取本方式,用户电脑端登录会挤掉API)
- 方式2:第一次登录传ipad,掉线后再次登录需传wcid和deviceType。(PS:和上次设备类型需一致,本方式登录,手机有概率会显示新设备验证,需切换Mac方式登录,本方式不影响用户电脑端登录微信)
关于自定义代理的使用说明:
- 若测试长效代理未包含您所在的城市,用户需自行购买/搭建自定义长效代理IP使用,否则会出现无法登录/秒掉/风控等情况(PS:须是中国电信网络归属且是支持Socks5的),例如第三方长效代理IP购买网站:四叶天、熊猫、青果等,可能部分平台需要设置白名单,将自助后台-API开通信息的IP添加即可。
- 若您传输地区后,扫码显示地区非本省/接口返回网络链接异常,请联系技术支持
- 若传自定义proxyIp相关参数则覆盖proxy登录地点,(自定义长效代理优点:安全去异地、避免风控、解决号秒掉、代理线路用户过多导致线路挂掉等意外情况)
- 若传自定义proxyIp相关参数,接口却返回网络链接异常,用户可通过本方式检测购买的代理IP是否正常且可访问,参考此处测试 ,
返回数据:
参数名 | 类型 | 说明 | |
---|---|---|---|
code | string | 1000成功,1001失败 | |
msg | string | 反馈信息 | |
data | |||
wId | string | 登录实例标识 (本值非固定的,每次重新登录会返回新的,数据库记得实时更新wid) | |
qrCodeUrl | string | 扫码登录地址 |
请求参数示例
{
//例:首次取码登录
"wcId": "",
"proxy": "2",
"deviceType":"mac",
"proxyIp": "",
"proxyUser": "",
"proxyPassword": "",
//例:掉线后,重新去取码登录
"wcId": "wxid_xxxxxxxxxxxx",
"proxy": "2",
"deviceType":"mac",
"proxyIp": "",
"proxyUser": "",
"proxyPassword": "",
//例:自定义代理IP,Wcid根据是否首次取码选择性填写,proxy随便填写,都会被自定义代理IP覆盖
"wcId": "",
"proxy": "2",
"deviceType":"mac",
"proxyIp": "181.7.128.33:91623",
"proxyUser": "test1234",
"proxyPassword": "test1234"
}
成功返回示例
{
"message": "登录成功",
"code": "1000",
"data": {
"wId": "0000016e-63ef-3a9c-0001-ed3311628ef4",
"qrCodeUrl": "http://127.0.0.1:18081/1573634652963-500000.png"
}
}
错误返回示例
{
"message": "用户名或密码错误",
"code": "1001",
"data": null
}