获取二维码(第二步-方式1)

请求URL:

  • http://域名地址/iPadLogin

请求方式:

  • POST

请求头Headers:

  • Content-Type:application/json
  • Authorization:login接口返回

参数:

参数名 必选 类型 说明
wcId string 微信原始id (首次登录平台的号传"",掉线重登必须传值,否则会频繁掉线!!!) 第3步会返回此字段,记得入库保存
deviceType string 设备类型:mac【推荐】、ipad
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:内蒙
aid string 网络类型2:本地代理id,需结合Aid工具使用在本地电脑端运行,微信登录期间,Aid工具需要不间断保持运行。此方式会覆盖proxy长效线路/自定义长效代理方式
proxyIp string 网络类型3: 自定义长效代理IP+端口
proxyUser string 网络类型3:自定义长效代理IP平台账号
proxyPassword string 网络类型3: 自定义长效代理IP平台密码

[!NOTE] 快速TIP:登录模块是本平台的必须步骤,若觉得过于繁琐,可省略第2步与第3步的登录步骤,直接在后台在线登录获取wid与wcId调用接口

关于设备类型的使用说明:

  • 若设备类型传ipad,且网络类型使用proxy的方式取码登录,手机上会大概率出现'在新设备完成验证以继续登录,导致无法登录成功,此时需要其他方式登录,可以切换Mac方式登录【100%登录】,也可以使用ipad+aid方式【50%概率不触发验证登录】,用户可根据自己的业务需求选择登录:
  • 方式1:第一次登录传mac,网络类型三选一都可,掉线后再次登录需传wcid和deviceType。(PS:和上次设备类型需一致,本方式登录,手机虽然概率会显示新设备验证,但是调用执行登录接口可手动通过该验证,采取本方式,用户电脑端登录会挤掉API)
  • 方式2:第一次登录传ipad,网络类型选择Aid【登录成功概率50%】/ 网络类型选择proxy【登录成功概率10%】,掉线后再次登录需传wcid和deviceType。(PS:和上次设备类型需一致,本方式登录,手机有概率会显示新设备验证,需切换Mac方式登录,本方式不影响用户电脑端登录微信)

关于网络类型的使用说明:

  • 安全性与稳定性:Aid>自定义代理>proxy,若用户有使用条件,推荐使用Aid方式。
  • 若“网络类型1”未包含您所在的城市,用户且无法使用“网络类型2”方式,此时可使用“网络类型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
}
Copyright © wkteam.cn 2020 all right reserved,powered by Gitbook该文件修订时间: 2025-09-14 23:29:42

results matching ""

    No results matching ""