获取二维码(第二步-方式1)
请求URL:
http://域名地址/iPadLogin
请求方式:
- POST
请求头Headers:
- Content-Type:application/json
- Authorization:login接口返回
参数:
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| wcId | 是 | string | 微信原始id (首次登录平台的号传"",掉线重登必须传值,否则会频繁掉线!!!) 第3步会返回此字段,记得入库保存 |
| deviceType | 是 | string | 设备类型:ipad【推荐】、mac |
| proxy | 是 | int | 网络类型1:网络代理线路 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:内蒙 |
| ttuid | 否 | string | 网络类型2:ttuid本地代理 用户需安装app/pc软件,打开后上传app/pc中的字段,登录成功之前请保持打开状态,建议传输网络代理/自定义代理一起使用 若是开发者公司有app/pc也可直接集成sdk至app/pc中,可以做到无需用户上传,且无需下载平台提供的软件 APP下载地址 Window/Mac客户端下载地址 |
| proxyIp | 否 | string | 网络类型3: 自定义长效代理IP+端口 |
| proxyUser | 否 | string | 网络类型3: 自定义长效代理IP平台账号 |
| proxyPassword | 否 | string | 网络类型3: 自定义长效代理IP平台密码 |
| aid | 否 | string | 网络类型4: aid用户电脑代理,需结合Aid工具使用在本地电脑端运行,微信登录期间,Aid工具需要不间断保持运行。此方式会覆盖proxy长效线路/自定义长效代理方式 |
[!NOTE] 快速TIP:登录模块是本平台的必须步骤,若觉得过于繁琐,可省略第2步与第3步的登录步骤,直接在后台在线登录获取wid与wcId调用接口
关于设备类型的使用说明:
- 设备类型若传ipad,不影响电脑端/手机端微信使用,设备类型若传Mac,则电脑端微信将会被挤下线
- 第一次登录传ipad/mac,网络类型四选一都可,掉线后再次登录需传wcid和deviceType。(PS:和上次设备类型必须一致,本方式登录,手机会显示新设备验证,需要调用执行登录接口进行二次处理,可通过该验证
关于网络类型的使用说明:
- 安全性与稳定性:aid用户电脑代理>ttuid本地代理+网络代理合并使用>自定义代理>网络代理,若用户有使用条件,推荐使用最稳定的方式。
- 若“网络类型1”未包含您所在的城市,用户且无法使用“网络类型2和4”,此时可使用“网络类型3”方式,自行购买/搭建自定义长效代理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
}