获取二维码(第二步)
请求URL:
请求方式:
- POST
请求头Headers:
- Authorization: Bearer xxx(PS:xxx是代表login接口返回,Bearer后面有个空格,除了login接口,后续所有接口都携带此参数)
- Content-Type:application/json
参数:
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
wxId | 是 | string | 微信id(第一次调用时可传空,后面访问必传,否则会导致环境异常,账号无法正常使用) |
proxyArea | 是 | int | 代理地点, 必须同省 1:北京 2:天津 3:上海 4:重庆 5:河北 6:山西 7:江苏 8:浙江 9:安徽 10:福建 11:江西 12:山东 13:河南 14:湖北 15:湖南 16:广东 17:海南 18:四川 20:陕西 |
proxy | 否 | string | 自定义代理ip 格式:socks5h://账号:密码@ip:端口 例:socks5h://admin:123456@181.112.111.100:7897 |
[!DANGER] 小提示:
- 开发者将本接口返回的二维码让企微用户去扫码,手机扫码结束后,需要调用第三步接口才会登录成功,且手机顶部显示mac已登录
- 若代理地点未包含您所在的城市,用户需自行购买/搭建自定义长效代理IP使用,否则会出现无法登录/秒掉/风控等情况(PS:须是中国电信网络归属且是支持Socks5的),例如第三方长效代理IP购买网站:四叶天(推荐)、熊猫、芝麻、青果等,可能部分平台需要设置白名单,将自助后台-API开通信息的IP添加即可。
- 传proxy相关参数则覆盖proxyArea登录地点,(自定义长效代理优点:安全去异地、避免风控、解决号秒掉、代理线路用户过多导致线路挂掉等意外情况)
- 若本接口返回网络链接异常,用户可通过本方式检测购买的代理IP是否正常且可访问,参考此处测试
返回数据:
参数名 | 类型 | 说明 |
---|---|---|
code | number | 200成功,其他失败 |
msg | string | 反馈信息 |
data | object | 返回对象 |
data.url | string | 二维码地址 |
data.sessionId | string | 企微授权id 同一个微信,不同的企业使用不同的sessionId,如果使用同一个id会导致sessionId冲突,登录失败 |
第一次请求参数示例
{"wxId":"",
"proxyArea":1
}
第二次登录及以后请求参数示例
{"wxId":"123132124141",
"proxyArea":1}
成功返回示例
{
"msg": "操作成功",
"code": 200,
"data": {
"url": "http://wxapi.oos-sccd.ctyunapi.cn/fee2db32ca0a4f45957redsd3bcf9356.jpg?AWSAccessKeyId=e14b8966201775518bce&Expires=1686372111&Signature=eqgzO%2F%2FkRbilE3CQIxBOV7RFQ58%3D",
"sessionId": "fee2db32ca0a4f45957fdead3bcf9356"
}
}
错误返回示例
{
"msg": "未找到微信登录信息 wxId:123",
"code": 500
}