默认模块Base URLs:wechatapi.netAuthentication开发API/登录模块POST (步骤1)获取登录二维码POST /login/getLoginQrCodeappId参数为设备ID首次登录传空会自动触发创建设备掉线后重新登录则必须传接口返回的appId注意同一个号避免重复创建设备以免触发官方风控- 登录时必须选择本省地区ID如无本省地区ID请自行购买本省或本市代理IP如果IPAD类型扫码登录提示“在新设备完成验证以继续登录” 需要更换type为mac进行登录切换顺序为ipad–mac。mac类型可以进行验证当mac出现新设备验证时参考执行登录接口。也可以直接使用mac登录取码时传的appId需要与上次登录扫码的微信一致否则会导致登录失败如果需要全局代理即所有接口都走代理可直接在调用的接口内增加 useProxy:true 字段。useproxy字段默认为false不单独展示在各个接口内但是有可能会影响接口的实时响应速度代理TTUID点击下载地区ID在前地区在后110000*北京市|120000*天津市|130000*河北省|140000*山西省|150000*内蒙古210000*辽宁省|220000*吉林省|230000*黑龙江310000*上海市|320000*江苏省|330000*浙江省|340000*安徽省|350000*福建省|360000*江西省|370000*山东省410000*河南省|420000*湖北省|430000*湖南省|440000*广东省|450000*广西省|460000*海南省500000*重庆市|510000*四川省|520000*贵州省|530000*云南省|540000*西藏自治区610000*陕西省|620000*甘肃省|630000*青海省|640000*宁夏自治区|650000*新疆自治区若目前支持的regionId中没有您所在的地区可以自行采购socks5协议代理IP填写到proxyIp参数中响应结果中的qrImgBase64为二维码图片的base64前端可使用此值展示给用户扫码。或使用响应结果中的qrData生成二维码地区ID仅供测试如需正常使用业务建议自行购买干净代理ip。Body 请求参数{appId:,proxyIp:,regionId:320000,type:ipad,ttuid:配合regionId/proxyIp使用,传ttuid程序生成的id}请求参数名称位置类型必选说明VideosApi-tokenheaderstring是PSAPI后台-点击访问控制-生成Tokenbodybodyobject否none» appIdbodystring否设备ID首次登录传空之后传接口返回的appId» proxyIpbodystring否代理IP 格式socks5://username:password123.2.2.2» regionIdbodystring是地区» typebodystring是设备类型ipad、mac默认为ipad。» ttuidbodystring否代理本机ID需配合 regionId/proxyIp 使用不单独使用。可临时借用用户的本地网络取码有50%概率跳过ipad验证。详细说明» type: 设备类型ipad、mac默认为ipad。独立appid返回示例200 Response{ret:0,msg:string,data:{qrData:string,qrUrl:string,appId:string,qrImgBase64:string,uuid:string}}返回结果状态码状态码含义说明数据模型200OKnoneInline返回数据结构状态码200名称类型必选约束中文名说明» retintegertruenonenone» msgstringtruenonenone» dataobjecttruenone响应数据»» qrDatastringtruenone二维码内包含的信息»» qrUrlstringtruenone二维码直接打开地址»» appIdstringtruenone设备ID»» qrImgBase64stringtruenone二维码图片base64»» uuidstringtruenone二维码的uuidPOST (步骤2)执行登录POST /login/checkLogin增加ipad人脸识别验证和mac滑块验证ipad仅支持IOS平台app扫码验证mac滑块验证支持app扫码验证和系统自动验证开发者集成平台也可自行集成APP滑块验证具体请点击ipad登录或者mac登录查看详情获取登录二维码扫码之后需每间隔5s调用本接口来判断是否登录成功二维码超时时间为120秒- 登录成功后logininfo有数据如果没有数据则需要一直执行直至出现登录数据或者失败为止。新设备登录平台次日凌晨会掉线一次重新登录时需调用获取二维码且传appId取码登录成功后则可以长期在线登录成功后请保存appId与wxid的对应关系后续接口中会用到☝️ 首次登录iPad出现**新设备验证**并且**无数字验证码**此时本接口会返回一个二维码网址开发者需使用IOS设备下载[安盾APP](https://www.pgyer.com/renzhengapp)扫描二维码网址扫描人脸通过后再次调用本接口手机点击确认则本接口返回登录结果。如果不进行人脸认证则需要切换Mac登录请查看Mac登录流程 ☝️ 首次登录iPad出现**新设备验证**并且**有数字验证码**直接在captchCode字段输入数字验证码继续执行登录即可登录。☝️ 首次登录Mac如果出现新设备验证可以**选择自动验证**不需要下载APP。 ☝️ 如果**不选择自动验证**会返回URL。生成二维码之后需要使用[安卓设备下载APP](https://pan.baidu.com/s/19EEi3Au-IzGT7pN7dQQfFQ?pwd81rg)扫码进行图形验证。操作完成后继续调用此接口即可通过新设备验证。 ☝️用户若有自己平台App则可代码接入无需下载AppFrame captionMac登录流程图不清楚流程必看Body 请求参数{appId:,proxyIp:,uuid:,autoSliding:true}请求参数名称位置类型必选说明VideosApi-tokenheaderstring是nonebodybodyobject否none» appIdbodystring是设备ID» proxyIpbodystring否代理IP 格式socks5://username:password123.2.2.2» uuidbodystring是获取二维码返回的uuid» captchCodebodystring否扫码后手机提示输入的验证码如未提示数字验证码可不传此字段。» autoSlidingbodyboolean是是否自动验证true/false仅限mac使用。true为自动验证false需要用app扫码验证。如果类型为ipad登录时必须传false。返回示例200 Response{ret:0,msg:string,data:{uuid:string,headImgUrl:string,nickName:string,expiredTime:0,status:0,loginInfo:{uin:0,wxid:string,nickName:string,mobile:string,alias:string}}}返回结果状态码状态码含义说明数据模型200OKnoneInline返回数据结构状态码200名称类型必选约束中文名说明» retintegertruenonenone» msgstringtruenonenone» dataobjecttruenone响应数据»» uuidstringtruenone二维码的uuid»» headImgUrlstringtruenone头像地址»» nickNamestringtruenone昵称»» expiredTimeintegertruenone二维码超时时间»» statusintegertruenone登录状态 0未扫码 1已扫码未登录 2登录成功 4已扫码取消登录»» loginInfoobjecttruenone登录成功信息»»» uinintegertruenoneuin»»» wxidstringtruenone微信ID返回此值则是登录成功»»» nickNamestringtruenone昵称»»» mobilestringtruenone绑定的手机号»»» aliasstringtruenone微信号POST 弹框登录POST /login/dialogLogin调用本接口后手机会弹框确认登录页面点确认后调用执行登录接口检测是否登录成功地区ID在前地区在后110000*北京市|120000*天津市|130000*河北省|140000*山西省|150000*内蒙古210000*辽宁省|220000*吉林省|230000*黑龙江310000*上海市|320000*江苏省|330000*浙江省|340000*安徽省|350000*福建省|360000*江西省|370000*山东省410000*河南省|420000*湖北省|430000*湖南省|440000*广东省|450000*广西省|460000*海南省500000*重庆市|510000*四川省|520000*贵州省|530000*云南省|540000*西藏自治区610000*陕西省|620000*甘肃省|630000*青海省|640000*宁夏自治区|650000*新疆自治区若目前支持的regionId中没有您所在的地区可以自行采购socks5协议代理IP填写到proxyIp参数中使用本接口登录并非100%成功本接口返回失败后可通过扫码登录的方式登录以下几种情况无法使用本接口登录手机点击退出登录新设备登录次日官方风控下线Body 请求参数{appId:wx_wR_U4zPj2M_OTS3BCyoE4,proxyIp:,regionId:320000}请求参数名称位置类型必选说明VideosApi-tokenheaderstring是nonebodybodyobject否none» appIdbodystring是设备ID» proxyIpbodystring是代理IP 格式socks5://username:password123.2.2.2» regionIdbodystring是地区返回示例200 Response{ret:0,msg:string,data:{appId:string,uuid:string}}返回结果状态码状态码含义说明数据模型200OKnoneInline返回数据结构状态码200名称类型必选约束中文名说明» retintegertruenonenone» msgstringtruenonenone» dataobjecttruenone响应数据»» appIdstringtruenone设备ID»» uuidstringtruenone二维码uuid执行登录时会用到POST 退出POST /login/logout可以只填写appid或者按照示例直接传即可Body 请求参数{appId:,proxyIp:,regionId:88}请求参数名称位置类型必选说明VideosApi-tokenheaderstring是nonebodybodyobject否none» appIdbodystring是设备ID返回示例200 Response{ret:200,msg:操作成功}返回结果状态码状态码含义说明数据模型200OKnoneInline返回数据结构状态码200名称类型必选约束中文名说明» retintegertruenonenone» msgstringtruenonenonePOST 检查是否在线POST /login/checkOnline响应结果的datatrue则是在线反之为离线Body 请求参数{appId:{{appid}}}请求参数名称位置类型必选说明VideosApi-tokenheaderstring是nonebodybodyobject否none» appIdbodystring是设备ID返回示例200 Response{ret:200,msg:操作成功,data:true}返回结果状态码状态码含义说明数据模型200OKnoneInline返回数据结构状态码200名称类型必选约束中文名说明» retintegertruenonenone» msgstringtruenonenone» databooleantruenonenonePOST 异常断线重连POST /login/reconnection账号在线但是收不到回调 调用此接口Body 请求参数{appId:}请求参数名称位置类型必选说明VideosApi-tokenheaderstring是nonebodybodyobject否none» appIdbodystring是设备ID返回示例200 Response{ret:200,msg:操作成功,data:true}返回结果状态码状态码含义说明数据模型200OKnoneInline返回数据结构状态码200名称类型必选约束中文名说明» retintegertruenonenone» msgstringtruenonenone» databooleantruenonenonePOST 无感切换代理ipPOST /login/setProxy账号更换代理ip可实现在线切换。也可退出后重新登录传新的代理ip。Body 请求参数{appId:{{appid}},proxyIp:socks5://x:x111.153.185.21:11332}请求参数名称位置类型必选说明VideosApi-tokenheaderstring是nonebodybodyobject否none» appIdbodystring是设备ID» proxyIpbodystring是代理ip返回示例200 Response{ret:0,msg:string}返回结果状态码状态码含义说明数据模型200OKnoneInline返回数据结构状态码200名称类型必选约束中文名说明» retintegertruenonenone» msgstringtruenonenone数据模型